How to Load Presentations in C++
Aspose.Slides FOSS for C++ ให้คุณเปิดไฟล์ .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) เท่านั้น. ไฟล์ Legacy .ppt (binary PowerPoint 97-2003) ไม่ได้รับการสนับสนุน.
รูปร่างไม่มี text_frame
รูปทรงบางประเภท (Connectors, PictureFrames, GroupShapes) ไม่มีกรอบข้อความ. ใช้ shape.has_text_frame() ก่อนเข้าถึงข้อความ.
คำถามที่พบบ่อย
การโหลดจะรักษาเนื้อหาต้นฉบับทั้งหมดไว้หรือไม่?
ใช่. ส่วน XML ที่ไม่รู้จักจะถูกเก็บไว้ตามต้นฉบับเมื่อตัวบันทึกรอบรอบ. ไลบรารีจะทำการซีเรียลไลซ์เฉพาะส่วนของโมเดลเอกสารที่มันเข้าใจเท่านั้น และจะส่งต่อ XML ใด ๆ ที่มันไม่รู้จัก.
ฉันสามารถโหลด PPTX ที่มีการป้องกันด้วยรหัสผ่านได้หรือไม่?
การนำเสนอที่มีการป้องกันด้วยรหัสผ่าน (เข้ารหัส) ไม่ได้รับการสนับสนุนในฉบับนี้.
ฉันสามารถดึงภาพที่ฝังอยู่ได้หรือไม่?
เข้าถึงคอลเลกชันของรูปภาพ: prs.images() คืนค่า ImageCollection. แต่ละรูปภาพมีเมธอด width(), height() และ binary_data() เพื่ออ่านข้อมูลรูปภาพดิบ.
การโหลดจากบัฟเฟอร์ในหน่วยความจำได้รับการสนับสนุนหรือไม่?
การโหลดจาก std::vector<uint8_t> หรือ std::istream ไม่ได้เปิดเผยใน API ปัจจุบัน เขียนไบต์ไปยังไฟล์ชั่วคราวก่อน แล้วจึงส่งพาธไปยังตัวสร้าง Presentation.