Aspose.Slides FOSS
C++
如何在 C++ 中加载演示文稿

如何在 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 （二进制 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 构造函数。.

另请参阅

 中文