在 C++ 中将 PPT 和 PPTX 转换为 PDF（包含高级功能）

概述

在 C++ 中将 PowerPoint 演示文稿（PPT、PPTX、ODP 等）转换为 PDF 格式具有多种优势，包括在不同设备之间的兼容性以及保留演示文稿的布局和格式。本指南演示了如何将演示文稿转换为 PDF 文档，使用各种选项控制图像质量，包含隐藏幻灯片，对 PDF 文件设置密码保护，检测字体替换，选择特定幻灯片进行转换，以及对输出文档应用合规性标准。

PowerPoint 转 PDF 转换

使用 Aspose.Slides，您可以将以下格式的演示文稿转换为 PDF：

• PPT
• PPTX
• ODP

要将演示文稿转换为 PDF，请将文件名作为参数传递给 Presentation 类，然后使用 Save 方法将演示文稿保存为 PDF。Presentation 类公开的 Save 方法通常用于将演示文稿转换为 PDF。

NOTE

Aspose.Slides for C++ 将其 API 信息和版本号插入到输出文档中。例如，在将演示文稿转换为 PDF 时，Aspose.Slides 会在 Application 字段填入 “Aspose.Slides"，在 PDF Producer 字段填入形如 “Aspose.Slides v XX.XX” 的值。注意，您无法指示 Aspose.Slides 更改或移除这些信息。

Aspose.Slides 允许您转换：

• 整个演示文稿为 PDF
• 演示文稿中的特定幻灯片为 PDF

Aspose.Slides 导出演示文稿为 PDF，确保生成的 PDF 与原始演示文稿高度匹配。转换过程中准确呈现的元素和属性包括：

• 图像
• 文本框和形状
• 文本格式
• 段落格式
• 超链接
• 页眉和页脚
• 项目符号
• 表格

将 PowerPoint 转换为 PDF

标准的 PowerPoint 到 PDF 转换过程使用默认选项。在这种情况下，Aspose.Slides 尝试使用最佳设置在最高质量水平下将提供的演示文稿转换为 PDF。

以下 C++ 代码展示了如何将演示文稿（PPT、PPTX、ODP 等）转换为 PDF：

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"PowerPoint.ppt");

// 将演示文稿保存为 PDF。
presentation->Save(u"PPT-to-PDF.pdf", SaveFormat::Pdf);

presentation->Dispose();

Aspose 提供了一个免费的在线 PowerPoint to PDF converter ，演示演示文稿到 PDF 的转换过程。您可以使用此转换器进行测试，以实时实现本文所述的过程。

使用选项将 PowerPoint 转换为 PDF

Aspose.Slides 提供自定义选项——位于 PdfOptions 类下的属性——允许您自定义生成的 PDF、使用密码锁定 PDF，或指定转换过程的执行方式。

使用自定义选项将 PowerPoint 转换为 PDF

使用自定义转换选项，您可以为光栅图像定义首选质量设置，指定元文件的处理方式，为文本设置压缩级别，配置图像的 DPI 等。

下面的代码示例演示如何使用多个自定义选项将 PowerPoint 演示文稿转换为 PDF：

// 实例化 PdfOptions 类。
auto pdfOptions = MakeObject<PdfOptions>();

// 设置 JPG 图像的质量。
pdfOptions->set_JpegQuality(90);

// 设置图像的 DPI。
pdfOptions->set_SufficientResolution(300);

// 设置元文件的处理方式。
pdfOptions->set_SaveMetafilesAsPng(true);

// 设置文本内容的压缩级别。
pdfOptions->set_TextCompression(PdfTextCompression::Flate);

// 定义 PDF 合规模式。
pdfOptions->set_Compliance(PdfCompliance::Pdf15);

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");

// 将演示文稿保存为 PDF 文档。
presentation->Save(u"PowerPoint-to-PDF.pdf", SaveFormat::Pdf, pdfOptions);

presentation->Dispose();

使用隐藏幻灯片将 PowerPoint 转换为 PDF

如果演示文稿包含隐藏幻灯片，您可以使用 PdfOptions 类的 set_ShowHiddenSlides 方法，将隐藏幻灯片作为页面包含在生成的 PDF 中。

以下 C++ 代码展示了如何在转换为 PDF 时包含隐藏幻灯片：

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");

// 实例化 PdfOptions 类。
auto pdfOptions = MakeObject<PdfOptions>();

// 添加隐藏幻灯片。
pdfOptions->set_ShowHiddenSlides(true);

// 将演示文稿保存为 PDF。
presentation->Save(u"PowerPoint-to-PDF.pdf", SaveFormat::Pdf, pdfOptions);

presentation->Dispose();

将 PowerPoint 转换为受密码保护的 PDF

以下 C++ 代码演示如何使用 PdfOptions 类的保护参数，将 PowerPoint 演示文稿转换为受密码保护的 PDF：

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");

// 实例化 PdfOptions 类。
auto pdfOptions = MakeObject<PdfOptions>();

// 设置 PDF 密码和访问权限。
pdfOptions->set_Password(u"password");
pdfOptions->set_AccessPermissions(PdfAccessPermissions::PrintDocument | PdfAccessPermissions::HighQualityPrint);

// 将演示文稿保存为 PDF。
presentation->Save(u"PPTX-to-PDF.pdf", SaveFormat::Pdf, pdfOptions);

presentation->Dispose();

检测字体替换

Aspose.Slides 提供了位于 PdfOptions 类下的 set_WarningCallback 方法，使您能够在演示文稿到 PDF 的转换过程中检测字体替换。

以下 C++ 代码演示如何检测字体替换：

// 警告回调的实现。
class FontSubstitutionHandler : public IWarningCallback
{
public:
    ReturnAction Warning(SharedPtr<IWarningInfo> warning) override;
};

ReturnAction FontSubstitutionHandler::Warning(SharedPtr<IWarningInfo> warning)
{
    if (warning->get_WarningType() == WarningType::DataLoss && 
        warning->get_Description().StartsWith(u"Font will be substituted"))
    {
        Console::WriteLine(u"Font substitution warning: {0}", warning->get_Description());
    }

    return ReturnAction::Continue;
}

int main()
{
    // 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
    auto presentation = MakeObject<Presentation>(u"sample.pptx");

    // 在 PDF 选项中设置警告回调。
    auto pdfOptions = MakeObject<PdfOptions>();
    pdfOptions->set_WarningCallback(MakeObject<FontSubstitutionHandler>());

    // 将演示文稿保存为 PDF。
    presentation->Save(u"output.pdf", SaveFormat::Pdf, pdfOptions);
    
    presentation->Dispose();

    return 0;
}

有关在渲染过程中接收字体替换回调的更多信息，请参阅 Getting Warning Callbacks for Fonts Substitution。

有关字体替换的更多信息，请参阅 Font Substitution 文章。

将 PowerPoint 中选定的幻灯片转换为 PDF

以下 C++ 代码演示如何仅将 PowerPoint 演示文稿中的特定幻灯片转换为 PDF：

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"PowerPoint.pptx");

// 设置幻灯片编号数组。
auto slides = MakeArray<int32_t>({ 1, 3 });

// 将演示文稿保存为 PDF。
presentation->Save(u"PPTX-to-PDF.pdf", slides, SaveFormat::Pdf);

presentation->Dispose();

使用自定义幻灯片尺寸将 PowerPoint 转换为 PDF

以下 C++ 代码演示如何使用指定的幻灯片尺寸将 PowerPoint 演示文稿转换为 PDF：

auto slideWidth = 612;
auto slideHeight = 792;

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"SelectedSlides.pptx");

// 创建一个带有调整后幻灯片尺寸的新演示文稿。
auto resizedPresentation = MakeObject<Presentation>();

// 设置自定义幻灯片尺寸。
resizedPresentation->get_SlideSize()->SetSize(slideWidth, slideHeight, SlideSizeScaleType::EnsureFit);

// 从原始演示文稿克隆第一张幻灯片。
auto slide = presentation->get_Slide(0);
resizedPresentation->get_Slides()->InsertClone(0, slide);

// 将调整大小后的演示文稿保存为带备注的 PDF。
resizedPresentation->Save(u"PDF_with_notes.pdf", SaveFormat::Pdf);

resizedPresentation->Dispose();
presentation->Dispose();

在备注幻灯片视图中将 PowerPoint 转换为 PDF

以下 C++ 代码演示如何将 PowerPoint 演示文稿转换为包含备注的 PDF：

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
auto presentation = MakeObject<Presentation>(u"SelectedSlides.pptx");

// 使用备注布局配置 PDF 选项。
auto notesOptions = MakeObject<NotesCommentsLayoutingOptions>();
notesOptions->set_NotesPosition(NotesPositions::BottomFull);
auto pdfOptions = MakeObject<PdfOptions>();
pdfOptions->set_SlidesLayoutOptions(notesOptions);

// 将演示文稿保存为带备注的 PDF。
presentation->Save(u"PDF_with_notes.tiff", SaveFormat::Pdf, pdfOptions);

presentation->Dispose();

PDF 的可访问性和合规性标准

Aspose.Slides 允许您使用符合 Web Content Accessibility Guidelines (WCAG) 的转换过程。您可以使用以下任意合规标准将 PowerPoint 文档导出为 PDF：PDF/A1a、PDF/A1b 和 PDF/UA。

以下 C++ 代码演示基于不同合规标准生成多个 PDF 的 PowerPoint 转 PDF 转换过程：

auto presentation = MakeObject<Presentation>(u"pres.pptx");

auto pdfOptionsA1a = MakeObject<PdfOptions>();

pdfOptionsA1a->set_Compliance(PdfCompliance::PdfA1a);
presentation->Save(u"pres-a1a-compliance.pdf", SaveFormat::Pdf, pdfOptionsA1a);

auto pdfOptionsA1b = MakeObject<PdfOptions>();
pdfOptionsA1b->set_Compliance(PdfCompliance::PdfA1b);
presentation->Save(u"pres-a1b-compliance.pdf", SaveFormat::Pdf, pdfOptionsA1b);

auto pdfOptionsUa = MakeObject<PdfOptions>();
pdfOptionsUa->set_Compliance(PdfCompliance::PdfUa);

presentation->Save(u"pres-ua-compliance.pdf", SaveFormat::Pdf, pdfOptionsUa);

presentation->Dispose();

Note

Aspose.Slides 支持 PDF 转换操作，允许您将 PDF 文件转换为常见文件格式。您可以执行 PDF to HTML、PDF to image、PDF to JPG、和 PDF to PNG 转换。其他针对专业格式的 PDF 转换操作——PDF to SVG、PDF to TIFF、以及 PDF to XML——也受到支持。

注意： 导出为 PDF/UA 时，Aspose.Slides 将 SmartArt、图表和公式等复杂图形视为单个图形。单独的路径元素不会保留为独立内容，可能被标记为伪影；仅为整个图形提供替代文本。

常见问题

我可以批量将多个 PowerPoint 文件转换为 PDF 吗？

是的，Aspose.Slides 支持将多个 PPT 或 PPTX 文件批量转换为 PDF。您可以遍历文件并以编程方式应用转换过程。

是否可以对已转换的 PDF 设置密码保护？

当然。使用 PdfOptions 类在转换过程中设置密码并定义访问权限。

如何在 PDF 中包含隐藏幻灯片？

使用 PdfOptions 类的 set_ShowHiddenSlides 方法即可在生成的 PDF 中包含隐藏幻灯片。

Aspose.Slides 能在 PDF 中保持高图像质量吗？

是的，您可以使用 set_JpegQuality 和 set_SufficientResolution 等方法（位于 PdfOptions 类）来控制图像质量，确保 PDF 中的图像保持高质量。

Aspose.Slides 支持 PDF/A 合规标准吗？

是的，Aspose.Slides 允许您导出符合多种标准的 PDF，包括 PDF/A1a、PDF/A1b 和 PDF/UA，确保文档满足可访问性和归档要求。

其他资源

• Aspose.Slides for C++ 文档
• Aspose.Slides for C++ API 参考
• Aspose 免费在线转换器