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

如何在 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）。不支持旧版 .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 构造函数。

另请参阅

 中文