วิธีโหลดงานนำเสนอใน C++

Aspose.Slides FOSS for C++ lets you open any .pptx ไฟล์, ตรวจสอบเนื้อหา, และบันทึกกลับเป็น PPTX หรือดึงข้อมูลจากไฟล์นั้นได้ คู่มือนี้ครอบคลุมการเปิดไฟล์, การวนลูปสไลด์, การอ่านข้อความของรูปร่าง, และการบันทึกแบบรอบกลับ.

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

ขั้นตอนที่ 1: สร้างและลิงก์ไลบรารี

git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .

ขั้นตอนที่ 2: เปิดงานนำเสนอที่มีอยู่

ส่งพาธของไฟล์ไปยัง Presentation คอนสตรัคเตอร์. ดิสทรัคเตอร์จัดการทำความสะอาด.

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

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

    asf::Presentation prs("input.pptx");
    std::cout << "Slide count: " << prs.slides().size() << "\n";
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

ส่วน XML ที่ไม่รู้จักในไฟล์ต้นทางจะถูกเก็บไว้โดยตรง: ไลบรารีจะไม่ลบเนื้อหาที่ยังไม่เข้าใจ.

ขั้นตอนที่ 3: ตรวจสอบสไลด์

วนลูปผ่านสไลด์ทั้งหมดและพิมพ์จำนวนรูปร่างของแต่ละสไลด์:

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

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

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        std::cout << "Slide " << i << ": "
                  << slide.shapes().size() << " shapes\n";
    }
    return 0;
}

ขั้นตอนที่ 4: อ่านข้อความของรูปร่าง

วนลูปผ่านรูปร่างและอ่านข้อความจากรูปร่างที่มี TextFrame:

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

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

    asf::Presentation prs("deck.pptx");
    for (size_t i = 0; i < prs.slides().size(); ++i) {
        auto& slide = prs.slides()[i];
        for (size_t j = 0; j < slide.shapes().size(); ++j) {
            auto& shape = slide.shapes()[j];
            if (shape.has_text_frame()) {
                auto text = shape.text_frame()->text();
                if (!text.empty()) {
                    std::cout << "  Shape text: " << text << "\n";
                }
            }
        }
    }
    return 0;
}

ขั้นตอนที่ 5: อ่านคุณสมบัติของเอกสาร

เข้าถึงคุณสมบัติหลักของเอกสารจาก prs.document_properties():

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

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

    asf::Presentation prs("deck.pptx");
    auto& props = prs.document_properties();
    std::cout << "Title:   " << props.title() << "\n";
    std::cout << "Author:  " << props.author() << "\n";
    std::cout << "Subject: " << props.subject() << "\n";
    return 0;
}

ขั้นตอนที่ 6: บันทึกแบบรอบ

หลังจากตรวจสอบหรือแก้ไขงานนำเสนอ, บันทึกกลับเป็น PPTX:

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

การบันทึกไปยังพาธที่ต่างกันจะสร้างไฟล์ใหม่. การบันทึกไปยังพาธเดียวกันจะเขียนทับไฟล์เดิม.

ปัญหาทั่วไปและวิธีแก้

ไม่พบไฟล์หรือไม่สามารถเปิดได้

ตรวจสอบว่าพาธไปยัง .pptx ไฟล์ถูกต้องตามเส้นทางสัมพันธ์กับไดเรกทอรีทำงาน. ใช้ std::filesystem::path สำหรับการสร้างพาธที่มั่นคง:

#include <filesystem>
auto path = std::filesystem::path(__FILE__).parent_path() / "assets" / "deck.pptx";
asf::Presentation prs(path.string());

ข้อยกเว้น: ไม่รองรับรูปแบบไฟล์

ไลบรารีสนับสนุน .pptx (Office Open XML) เท่านั้น. รุ่นเก่า .ppt (binary PowerPoint 97-2003) ไม่ได้รับการสนับสนุน.

รูปร่างไม่มี text_frame

รูปร่างบางประเภท (Connectors, PictureFrames, GroupShapes) ไม่มีกรอบข้อความ. ป้องกันด้วย shape.has_text_frame() ก่อนเข้าถึงข้อความ.

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

การโหลดจะคงเนื้อหาต้นฉบับทั้งหมดหรือไม่?

ใช่ ส่วน XML ที่ไม่รู้จักจะถูกเก็บไว้ตามต้นฉบับเมื่อตัวบันทึกรอบการทำงาน ไลบรารีจะทำการซีเรียลไลซ์เฉพาะส่วนของโมเดลเอกสารที่เข้าใจเท่านั้น และส่งต่อ XML ใด ๆ ที่ไม่รู้จักต่อไป.

ฉันสามารถโหลดไฟล์ PPTX ที่มีการป้องกันด้วยรหัสผ่านได้หรือไม่?

การนำเสนอที่ป้องกันด้วยรหัสผ่าน (เข้ารหัส) ไม่ได้รับการสนับสนุนในรุ่นนี้.

ฉันสามารถดึงภาพที่ฝังอยู่ได้หรือไม่?

เข้าถึงคอลเลกชันของรูปภาพ: prs.images() คืนค่า ImageCollection. แต่ละรูปมี a width(), height(), และ binary_data() วิธีการอ่านข้อมูลภาพดิบ.

การโหลดจากบัฟเฟอร์ในหน่วยความจำได้รับการสนับสนุนหรือไม่?

กำลังโหลดจาก std::vector<uint8_t> หรือ std::istream ไม่ได้เปิดเผยใน API ปัจจุบัน เขียนไบต์ลงในไฟล์ชั่วคราวก่อน แล้วจึงส่งพาธไปยัง Presentation คอนสตรัคเตอร์.