วิธีสร้างงานนำเสนอใน C++

Aspose.Slides FOSS for C++ ให้คุณสร้างงานนำเสนอ PowerPoint ทั้งหมดด้วย C++ โดยไม่ต้องพึ่งพา Microsoft Office คู่มือฉบับนี้แสดงวิธีสร้างงานนำเสนอใหม่ เพิ่มสไลด์และรูปทรง จัดรูปแบบข้อความ และบันทึกผลลัพธ์.

คู่มือแบบขั้นตอนต่อขั้นตอน

ขั้นตอนที่ 1: เพิ่มไลบรารีลงในโครงการ CMake ของคุณ

ใช้ CMake FetchContent เพื่อรวมไลบรารีโดยตรงจาก GitHub. จำเป็นต้องใช้ C++20 หรือใหม่กว่า.

cmake_minimum_required(VERSION 3.20)
project(my_slides_app LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(FetchContent)
FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG main
)
FetchContent_MakeAvailable(aspose_slides_foss)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

ไม่จำเป็นต้องมีแพ็คเกจระบบอื่นใด.

ขั้นตอนที่ 2: รวมส่วนหัวที่จำเป็น

#include <Aspose/Slides/Foss/presentation.h>

ประเภททั้งหมดอยู่ในเนมสเปซ Aspose::Slides::Foss. เพื่อความกระชับ ตัวอย่างด้านล่างใช้นามแฝงของเนมสเปซ:

namespace asf = Aspose::Slides::Foss;

ขั้นตอนที่ 3: สร้างงานนำเสนอ

สร้าง Presentation บนสแตก. การนำเสนอใหม่เริ่มต้นด้วยสไลด์เปล่า 1 แผ่น.

#include <Aspose/Slides/Foss/presentation.h>
#include <iostream>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    std::cout << "Slides in new presentation: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

สำคัญ: ใช้ stack allocation หรือ std::unique_ptr เพื่อให้ destructor ปล่อยทรัพยากรภายในโดยอัตโนมัติ.

ขั้นตอนที่ 4: เข้าถึงสไลด์

สไลด์แรกอยู่ที่ดัชนี 0. การนำเสนอเปล่ามีสไลด์เพียงหนึ่งสไลด์เท่านั้น.

namespace asf = Aspose::Slides::Foss;

asf::Presentation prs;
auto& slide = prs.slides()[0]; // zero-based index
prs.save("output.pptx", asf::SaveFormat::PPTX);

ขั้นตอนที่ 5: เพิ่มรูปทรง

ใช้ slide.shapes().add_auto_shape() เพื่อเพิ่ม AutoShape พารามิเตอร์คือ (shape_type, x, y, width, height) ทั้งหมดเป็นจุด (1 จุด = 1/72 นิ้ว; สไลด์มาตรฐานคือ 720 x 540 pt).

#include <Aspose/Slides/Foss/presentation.h>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;
    auto& slide = prs.slides()[0];

    // Rectangle at (50, 50) with 400 wide and 120 tall
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 400, 120);

    // Set text on the shape's text frame
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");

    prs.save("with-shape.pptx", asf::SaveFormat::PPTX);
    return 0;
}

ขั้นตอนที่ 6: บันทึกงานนำเสนอ

เรียก prs.save(path, SaveFormat::PPTX) ก่อนที่ Presentation จะออกจากขอบเขต. PPTX เป็นรูปแบบผลลัพธ์ที่รองรับเพียงอย่างเดียว.

prs.save("result.pptx", asf::SaveFormat::PPTX);

ไฟล์ถูกเขียนแบบอะตอมิก; หากเกิดข้อผิดพลาดก่อนการเรียกนี้ จะไม่มีไฟล์ผลลัพธ์ถูกสร้างขึ้น.

ตัวอย่างการทำงานที่สมบูรณ์

โปรแกรมต่อไปนี้สร้างการนำเสนอสองสไลด์โดยมีรูปร่างหัวเรื่องบนสไลด์แรกและตารางบนสไลด์ที่สอง.

#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>

int main() {
    namespace asf = Aspose::Slides::Foss;

    asf::Presentation prs;

    // --- Slide 1: title shape ---
    auto& slide1 = prs.slides()[0];
    auto& title = slide1.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 40, 40, 640, 80);
    title.text_frame()->set_text("Q1 Results: Executive Summary");
    auto& fmt = title.text_frame()->paragraphs()[0].portions()[0].portion_format();
    fmt.set_font_height(32);
    fmt.set_font_bold(asf::NullableBool::TRUE);
    fmt.fill_format().set_fill_type(asf::FillType::SOLID);
    fmt.fill_format().solid_fill_color().set_color(
        asf::Color::from_argb(255, 0, 70, 127));

    // --- Slide 2: table ---
    prs.slides().add_empty_slide(&prs.layout_slides()[0]);
    auto& slide2 = prs.slides()[1];
    std::vector<double> col_w = {200.0, 120.0, 120.0};
    std::vector<double> row_h = {40.0, 40.0, 40.0};
    auto& table = slide2.shapes().add_table(40, 40, col_w, row_h);

    std::vector<std::string> headers = {"Region", "Revenue", "Growth"};
    std::vector<std::vector<std::string>> data = {
        {"North", "$1.2M", "+8%"},
        {"South", "$0.9M", "+4%"},
    };
    for (size_t col = 0; col < headers.size(); ++col) {
        table.rows()[0][col].text_frame()->set_text(headers[col]);
    }
    for (size_t r = 0; r < data.size(); ++r) {
        for (size_t c = 0; c < data[r].size(); ++c) {
            table.rows()[r + 1][c].text_frame()->set_text(data[r][c]);
        }
    }

    prs.save("q1-results.pptx", asf::SaveFormat::PPTX);
    return 0;
}

ปัญหาทั่วไปและการแก้ไข

Segfault หรือ double-free ขณะทำลาย Presentation

คุณกำลังเก็บอ้างอิงหรือพอยน์เตอร์ไปยังสไลด์หรือรูปร่างหลังจากที่ Presentation ถูกทำลายแล้ว การอ้างอิงทั้งหมดที่คืนค่าจาก slides(), shapes() ฯลฯ จะถูกทำให้ไม่ถูกต้องเมื่อตัวทำลายของ Presentation ทำงาน ให้คง Presentation อยู่ตลอดระยะเวลาที่คุณใช้อ็อบเจ็กต์ลูกของมัน.

SaveFormat::PPTX is not a function ข้อผิดพลาดของคอมไพเลอร์

SaveFormat::PPTX เป็นค่า enum ไม่ใช่ฟังก์ชัน. ใช้เป็น prs.save("file.pptx", asf::SaveFormat::PPTX).

ข้อผิดพลาดของลิงเกอร์: การอ้างอิงที่ไม่ได้กำหนด Aspose::Slides::Foss::Presentation

ตรวจสอบให้แน่ใจว่า CMakeLists.txt ของคุณเชื่อมโยงกับไลบรารีด้วย target_link_libraries(my_app PRIVATE aspose_slides_foss).

คำถามที่พบบ่อย

ขนาดสไลด์เริ่มต้นคืออะไร?

Presentation() ใหม่สร้างสไลด์ที่ขนาดมาตรฐาน 10 x 7.5 นิ้ว (720 x 540 จุด). การเปลี่ยนขนาดสไลด์ยังไม่รองรับในฉบับนี้.

ฉันสามารถเพิ่มสไลด์ได้มากกว่าหนึ่งสไลด์หรือไม่?

ใช่. เรียก prs.slides().add_empty_slide(&prs.layout_slides()[0]) เพื่อเพิ่มสไลด์เปล่าและเข้าถึงโดยใช้ดัชนี:

prs.slides().add_empty_slide(&prs.layout_slides()[0]);
auto& slide2 = prs.slides()[1];

ฉันสามารถเปิดไฟล์ที่มีอยู่แล้วและเพิ่มสไลด์ได้หรือไม่?

ใช่:

asf::Presentation prs("existing.pptx");
prs.slides().add_empty_slide(&prs.layout_slides()[0]);
prs.save("existing.pptx", asf::SaveFormat::PPTX);

ฉันสามารถบันทึกเป็นรูปแบบใดได้บ้าง?

มีการสนับสนุนเฉพาะ SaveFormat::PPTX เท่านั้น. การส่งออกเป็น PDF, HTML, SVG หรือรูปภาพไม่พร้อมใช้งานในรุ่นนี้.