Aspose.Slides FOSS
C++
如何在 C++ 中保存演示文稿

如何在 C++ 中保存演示文稿

Aspose.Slides FOSS for C++ 将演示文稿仅保存为 .pptx 格式，使用 prs.save(path, SaveFormat::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：打开或创建演示文稿

使用栈分配，以便析构函数自动清理。 在对象超出作用域之前调用 save()。

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

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

    // Create new
    {
        asf::Presentation prs;
        prs.save("new.pptx", asf::SaveFormat::PPTX);
    }

    // Open existing
    {
        asf::Presentation prs("input.pptx");
        prs.save("output.pptx", asf::SaveFormat::PPTX);
    }

    return 0;
}

步骤 3：在所有修改后保存

在所有修改完成后放置 save() 调用，但在 Presentation 超出作用域之前。

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

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

    asf::Presentation prs;
    auto& slide = prs.slides()[0];
    auto& shape = slide.shapes().add_auto_shape(
        asf::ShapeType::RECTANGLE, 50, 50, 300, 100);
    shape.text_frame()->set_text("Hello, World!");
    prs.save("output.pptx", asf::SaveFormat::PPTX);
    return 0;
}

步骤 4：保存到不同的路径

传递不同的输出路径以创建新文件，而不修改原始文件：

asf::Presentation prs("template.pptx");
// modify ...
prs.save("customized.pptx", asf::SaveFormat::PPTX);

template.pptx 文件未被修改；customized.pptx 被创建（如果已存在则会被覆盖）。

步骤 5：验证输出

保存后，检查文件是否存在：

#include <filesystem>
#include <iostream>

auto output = std::filesystem::path("output.pptx");
std::cout << "Saved: " << std::filesystem::exists(output)
          << ", size: " << std::filesystem::file_size(output) << " bytes\n";

支持的保存格式

格式枚举值支持
PPTX（Office Open XML）SaveFormat::PPTX是
PDFN/A否
HTMLN/A否
SVGN/A否
PNG / JPEGN/A否
ODP（OpenDocument）N/A否

仅支持 PPTX。尝试以其他任何格式保存将抛出异常。

常见问题及解决方案

写入时的权限被拒绝错误

输出文件已在其他应用程序中打开（例如，PowerPoint 已打开该文件）。在保存之前，请先关闭其他应用程序中的文件。

文件已创建但显示为空或已损坏

确保在销毁 Presentation 对象之前调用 prs.save()。销毁后，内部状态将被释放，随后调用将失败或产生无效输出。

保存时出现异常

当尝试将保存格式设为非 PPTX，或在保存过程中使用不受支持的功能（例如图表或动画）时，会出现此情况。

常见问题

我可以保存到我打开的同一个文件吗？

是的。保存到相同路径会覆盖原始文件：

asf::Presentation prs("deck.pptx");
// modify ...
prs.save("deck.pptx", asf::SaveFormat::PPTX); // overwrites original

我可以将其保存到内存缓冲区而不是文件吗？

当前 API 不支持直接保存到 std::vector<uint8_t> 或 std::ostream。请先保存到临时文件并读取字节：

#include <filesystem>
#include <fstream>
#include <vector>

auto tmp = std::filesystem::temp_directory_path() / "temp.pptx";
prs.save(tmp.string(), asf::SaveFormat::PPTX);

std::ifstream in(tmp, std::ios::binary);
std::vector<uint8_t> bytes((std::istreambuf_iterator<char>(in)),
                            std::istreambuf_iterator<char>());
std::filesystem::remove(tmp);

保存是否会保留我未修改的内容？

是的。原始文件中的未知 XML 部分会原样保留。该库仅序列化其能够理解的文档模型部分，并会直接传递任何它不识别的 XML。

另请参阅

 中文