在 .NET 中将 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 .NET 会将其 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 类。
using var presentation = new Presentation("PowerPoint.ppt");

// 将演示文稿保存为 PDF。
presentation.Save("PDF-result.pdf", SaveFormat.Pdf);

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

使用选项将 PowerPoint 转换为 PDF

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

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

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

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

// 实例化 PdfOptions 类。
var pdfOptions = new PdfOptions
{
    // 设置 JPG 图像的质量。
    JpegQuality = 90,

    // 设置图像的 DPI。
    SufficientResolution = 300,

    // 设置元文件的处理方式。
    SaveMetafilesAsPng = true,

    // 设置文本内容的压缩级别。
    TextCompression = PdfTextCompression.Flate,

    // 定义 PDF 合规模式。
    Compliance = PdfCompliance.Pdf15
};

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
using var presentation = new Presentation("PowerPoint.pptx");

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

将 PowerPoint 转换为包含隐藏幻灯片的 PDF

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

下面的 C# 代码展示了如何在转换为 PDF 时包括隐藏幻灯片：

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
using var presentation = new Presentation("PowerPoint.pptx");

// 实例化 PdfOptions 类。
var pdfOptions = new PdfOptions();

// 添加隐藏幻灯片。
pdfOptions.ShowHiddenSlides = true;

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

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

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

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
using var presentation = new Presentation("PowerPoint.pptx");

// 实例化 PdfOptions 类。
var pdfOptions = new PdfOptions();

// 设置 PDF 密码和访问权限。
pdfOptions.Password = "password";
pdfOptions.AccessPermissions = PdfAccessPermissions.PrintDocument | PdfAccessPermissions.HighQualityPrint;

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

检测字体替换

Aspose.Slides 在PdfOptions类下提供WarningCallback属性，帮助您在演示文稿转 PDF 过程中检测字体替换。

下面的 C# 代码展示了如何检测字体替换：

public static void Main()
{
    // 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。 
    using var presentation = new Presentation("sample.pptx");

    // 在 PDF 选项中设置警告回调。
    var pdfOptions = new PdfOptions();
    pdfOptions.WarningCallback = new FontSubstitutionHandler();

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

// 警告回调的实现。
private class FontSubstitutionHandler : IWarningCallback
{
    public ReturnAction Warning(IWarningInfo warning)
    {
        if (warning.WarningType == WarningType.DataLoss &&
            warning.Description.StartsWith("Font will be substituted"))
        {
            Console.WriteLine($"Font substitution warning: {warning.Description}");
        }

        return ReturnAction.Continue;
    }
}

有关在渲染过程中接收字体替换回调的更多信息，请参阅获取字体替换警告回调。

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

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

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

// 实例化表示 PowerPoint 或 OpenDocument 文件的 Presentation 类。
using var presentation = new Presentation("PowerPoint.pptx");

// 设置幻灯片编号数组。
int[] slides = { 1, 3 };

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

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

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

var slideWidth = 612;
var slideHeight = 792;

// 加载 PowerPoint 演示文稿。
using var presentation = new Presentation("SelectedSlides.pptx");

// 创建一个具有调整后幻灯片尺寸的新演示文稿。
using var resizedPresentation = new Presentation();

// 设置自定义幻灯片尺寸。
resizedPresentation.SlideSize.SetSize(slideWidth, slideHeight, SlideSizeScaleType.EnsureFit);

// 从原始演示文稿克隆第一张幻灯片。
var slide = presentation.Slides[0];
resizedPresentation.Slides.InsertClone(0, slide);

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

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

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

// 加载 PowerPoint 演示文稿。
using var presentation = new Presentation("NotesFile.pptx");

// 使用备注布局配置 PDF 选项。
var pdfOptions = new PdfOptions
{
    SlidesLayoutOptions = new NotesCommentsLayoutingOptions
    {
        NotesPosition = NotesPositions.BottomFull
    }
};

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

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

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

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

using var presentation = new Presentation("pres.pptx");

presentation.Save("pres-a1a-compliance.pdf", SaveFormat.Pdf, new PdfOptions
{
    Compliance = PdfCompliance.PdfA1a
});

presentation.Save("pres-a1b-compliance.pdf", SaveFormat.Pdf, new PdfOptions
{
    Compliance = PdfCompliance.PdfA1b
});

presentation.Save("pres-ua-compliance.pdf", SaveFormat.Pdf, new PdfOptions
{
    Compliance = PdfCompliance.PdfUa
});

Note

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

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

常见问题解答

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

能否为转换后的 PDF 设置密码保护？
完全可以。使用PdfOptions类在转换过程中设置密码并定义访问权限。

如何在 PDF 中包含隐藏幻灯片？
在PdfOptions类中将ShowHiddenSlides属性设置为true，即可在生成的 PDF 中包含隐藏幻灯片。

Aspose.Slides 能在 PDF 中保持高图像质量吗？
可以。通过在PdfOptions类中设置JpegQuality、SufficientResolution 等属性，您可以确保 PDF 中的图像保持高质量。

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

附加资源

在 .NET 中将 PowerPoint 幻灯片转换为 PNG 在 .NET 中将 PowerPoint 演示文稿转换为带备注的 PDF