PdfOptions

PdfOptions 类

提供控制演示文稿以 Pdf 格式保存方式的选项。

public class PdfOptions : SaveOptions, IPdfOptions

构造函数

名称描述
PdfOptions()默认构造函数。

属性

名称描述
AccessPermissions { get; set; }包含一组标志，指定在使用用户访问打开文档时应授予的访问权限。参见 PdfAccessPermissions。
AdditionalCommonFontFamilies { get; set; }返回或设置 Aspose.Slides 应视为通用的用户自定义字体系列名称数组。可读写 String[].
ApplyImageTransparent { get; set; }如果为 true，则对图像应用指定的透明颜色。
BestImagesCompressionRatio { get; set; }指示是否应自动为每个图像选择最有效的压缩（而非默认压缩）。如果设置为 Boolean.true，则为演示文稿中的每个图像选择最合适的压缩算法，从而减小生成的 PDF 文档大小。最佳图像压缩比选择计算成本高且需要额外的内存，默认值为 Boolean.false。
Compliance { get; set; }生成的 PDF 文档的期望符合性级别。可读写 PdfCompliance。
DefaultRegularFont { get; set; }返回或设置在未找到源字体时使用的字体。可读写 String。
DrawSlidesFrame { get; set; }设为 true 可在每张幻灯片周围绘制黑色框。可读写 Boolean。
EmbedFullFonts { get; set; }确定是应嵌入字体的所有字符还是仅使用子集。可读写 Boolean。
EmbedTrueTypeFontsForASCII { get; set; }确定 Aspose.Slides 是否为 ASCII（33..127 码范围）文本嵌入通用字体。码值大于 127 的字符始终嵌入。通用字体列表包括 PDF 的基本 14 种字体以及用户指定的其他字体。可读写 Boolean。
GradientStyle { get; set; }返回或设置渐变的视觉样式。可读写 GradientStyle。
ImageTransparentColor { get; set; }获取或设置图像的透明颜色。
IncludeOleData { get; set; }设为 true 可将演示文稿中的所有 OLE 数据转换为生成的 PDF 中的嵌入文件。可读写 Boolean。
InkOptions { get; }提供控制导出文档中墨迹对象外观的选项。只读 IInkOptions
JpegQuality { get; set; }返回或设置决定 PDF 文档中 JPEG 图像质量的值。可读写 Byte。
Password { get; set; }设置用于保护 PDF 文档的用户密码。可读写 String。
ProgressCallback { get; set; }表示用于保存进度更新（百分比）的回调对象。参见 IProgressCallback。
RasterizeUnsupportedFontStyles { get; set; }指示在字体不支持粗体样式时是否应将文本光栅化为位图并保存到 PDF。此方法可提升某些字体在生成的 PDF 中的文本质量。可读写 Boolean。
SaveMetafilesAsPng { get; set; }设为 true 可将演示文稿中使用的所有元文件转换为 PNG 图像。可读写 Boolean。
ShowHiddenSlides { get; set; }指定生成的文档是否应包含隐藏幻灯片。默认值为 false。
SkipJavaScriptLinks { get; set; }指定在保存演示文稿时是否跳过带有 JavaScript 调用的超链接。可读写 Boolean。默认值为 false。
SlidesLayoutOptions { get; set; }获取或设置在导出演示文稿时幻灯片在页面上的放置模式 ISlidesLayoutOptions。
SufficientResolution { get; set; }返回或设置决定 PDF 文档中图像分辨率的值。
TextCompression { get; set; }指定用于文档中所有文本内容的压缩类型。可读写 PdfTextCompression。
WarningCallback { get; set; }返回或设置接收警告并决定加载过程是继续还是中止的对象。可读写 IWarningCallback。

示例

以下示例演示如何使用自定义选项将 PowerPoint 转换为 PDF。

[C#]
using (Presentation presentation = new Presentation("PowerPoint.pptx"))
{
	// 实例化 PdfOptions 类
	PdfOptions pdfOptions = new PdfOptions();
	// 设置 Jpeg 质量
	pdfOptions.JpegQuality = 90;
	// 设置元文件的行为
	pdfOptions.SaveMetafilesAsPng = true;
	// 设置文本压缩级别
	pdfOptions.TextCompression = PdfTextCompression.Flate;
	// 定义 PDF 标准
	pdfOptions.Compliance = PdfCompliance.Pdf15;
	// 将演示文稿保存为 PDF
	presentation.Save("PowerPoint-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
}

以下示例演示如何将 PowerPoint 转换为包含隐藏幻灯片的 PDF。

[C#]
// 实例化一个表示 PowerPoint 文件的 Presentation 类
using (Presentation presentation = new Presentation("PowerPoint.pptx"))
{
	// 实例化 PdfOptions 类
	PdfOptions pdfOptions = new PdfOptions();
	// 添加隐藏幻灯片
	pdfOptions.ShowHiddenSlides = true;
	// 将演示文稿保存为 PDF
	presentation.Save("PowerPoint-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
}

以下示例演示如何将 PowerPoint 转换为受密码保护的 PDF。

[C#]
// 实例化一个表示 PowerPoint 文件的 Presentation 对象
using (Presentation presentation = new Presentation("PowerPoint.pptx"))
{
	/// 实例化 PdfOptions 类
	PdfOptions pdfOptions = new PdfOptions();
	// 设置 PDF 密码和访问权限
	pdfOptions.Password = "password";
	pdfOptions.AccessPermissions = PdfAccessPermissions.PrintDocument | PdfAccessPermissions.HighQualityPrint;
	// 将演示文稿保存为 PDF
	presentation.Save("PPTX-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
}

以下示例演示如何将 PowerPoint 转换为带有备注的 PDF。

[C#]
// 实例化一个表示演示文稿文件的 Presentation 对象
using (Presentation presentation = new Presentation("SelectedSlides.pptx"))
{
	using (Presentation auxPresentation = new Presentation())
	{
		ISlide slide = presentation.Slides[0];
		auxPresentation.Slides.InsertClone(0, slide);
		// 设置幻灯片类型和大小
		//auxPresentation.SlideSize.SetSize(presentation.SlideSize.Size.Width, presentation.SlideSize.Size.Height,SlideSizeScaleType.EnsureFit);
		auxPresentation.SlideSize.SetSize(612F, 792F, SlideSizeScaleType.EnsureFit);
		PdfOptions pdfOptions = new PdfOptions();
		pdfOptions.SlidesLayoutOptions = new NotesCommentsLayoutingOptions() { NotesPosition = NotesPositions.BottomFull };
		auxPresentation.Save("PDFnotes_out.pdf", SaveFormat.Pdf, pdfOptions);
	}
}

另见

PdfCompliance PdfTextCompression