PdfSaveOptions

PdfSaveOptions class

可用于在将文档保存到Pdf格式.

要了解更多信息，请访问指定保存选项文档文章。

public class PdfSaveOptions : FixedPageSaveOptions

构造函数

姓名描述
PdfSaveOptions()初始化此类的新实例，该实例可用于在 中保存文档Pdf格式.

特性

姓名描述
AdditionalTextPositioning { get; set; }指定是否写入附加文本定位运算符的标志。
AllowEmbeddingPostScriptFonts { get; set; }获取或设置一个布尔值，指示在保存的文档中嵌入 TrueType 字体时是否允许使用 PostScript 轮廓嵌入字体。 默认值为错误的.
CacheBackgroundGraphics { get; set; }获取或设置一个值，确定是否缓存放置在文档背景中的图形。
ColorMode { get; set; }获取或设置一个确定颜色呈现方式的值。
Compliance { get; set; }指定输出文档的 PDF 标准合规级别。
CreateNoteHyperlinks { get; set; }指定是否将正文故事中的脚注/尾注引用转换为活动超链接。 单击时，超链接将指向相应的脚注/尾注。 默认为错误的.
CustomPropertiesExport { get; set; }获取或设置确定方式的值CustomDocumentProperties导出为 PDF 文件。
CustomTimeZoneInfo { get; set; }获取或设置用于日期/时间字段的自定义本地时区。
DefaultTemplate { get; set; }获取或设置默认模板的路径（包括文件名）。 此属性的默认值为空字符串（Empty).
DigitalSignatureDetails { get; set; }获取或设置用于签署输出 PDF 文档的详细信息。
DisplayDocTitle { get; set; }一个标志，指定窗口的标题栏是否应显示取自 文档信息字典的标题条目的文档标题。
Dml3DEffectsRenderingMode { get; set; }获取或设置一个确定如何渲染 3D 效果的值。
override DmlEffectsRenderingMode { get; set; }获取或设置一个值，确定如何呈现 DrawingML 效果。
DmlRenderingMode { get; set; }获取或设置一个值，确定如何呈现 DrawingML 形状。
DownsampleOptions { get; set; }允许指定下采样选项。
EmbedAttachments { get; set; }获取或设置一个值，确定是否将附件嵌入到 PDF 文档中。
EmbedFullFonts { get; set; }控制如何将字体嵌入到生成的 PDF 文档中。
EncryptionDetails { get; set; }获取或设置加密输出 PDF 文档的详细信息。
ExportDocumentStructure { get; set; }获取或设置决定是否导出文档结构的值。
ExportGeneratorName { get; set; }当真的 ，导致 Aspose.Words 的名称和版本嵌入到生成的文件中。 默认值为真的.
ExportLanguageToSpanTag { get; set; }获取或设置一个值，确定是否在文档结构中创建“Span”标签以导出文本语言。
ExportParagraphGraphicsToArtifact { get; set; }获取或设置一个值，确定段落图形是否应标记为工件。
FontEmbeddingMode { get; set; }指定字体嵌入模式。
HeaderFooterBookmarksExportMode { get; set; }确定如何导出页眉/页脚中的书签。
ImageColorSpaceExportMode { get; set; }指定如何为 PDF 文档中的图像选择色彩空间。
ImageCompression { get; set; }指定文档中所有图像要使用的压缩类型。
ImlRenderingMode { get; set; }获取或设置一个值，确定如何呈现墨迹 (InkML) 对象。
InterpolateImages { get; set; }指示图像插值是否应由合格读取器执行的标志。 当错误的指定后，该标志不会写入输出文档，并且 改为使用阅读器的默认行为。
JpegQuality { get; set; }获取或设置决定 PDF 文档内 JPEG 图像质量的值。
MemoryOptimization { get; set; }获取或设置确定在保存文档之前是否应执行内存优化的值。 此属性的默认值为错误的.
MetafileRenderingOptions { get; set; }允许指定图元文件渲染选项。
NumeralFormat { get; set; }获取或设置NumeralFormat用于呈现数字。 默认使用欧洲数字。
OpenHyperlinksInNewWindow { get; set; }获取或设置一个值，该值确定是否强制在浏览器的新窗口（或选项卡）中打开输出 Pdf 文档 中的超链接。
virtual OptimizeOutput { get; set; }标志指示是否需要优化输出。 如果设置此标志，则冗余嵌套画布并删除空画布， 还将连接具有相同格式的相邻字形。 注意：如果出现以下情况，内容显示的准确性可能会受到影响该属性设置为真的. 默认为错误的.
OutlineOptions { get; }允许指定轮廓选项。
PageMode { get; set; }指定在 PDF 阅读器中打开 PDF 文档时应如何显示。
PageSavingCallback { get; set; }允许控制将文档导出为固定页面格式时如何保存单独的页面。
PageSet { get; set; }获取或设置要呈现的页面。 默认为文档中的所有页面。
PreblendImages { get; set; }获取或设置一个值，确定是否预混合具有黑色背景颜色的透明图像。
PreserveFormFields { get; set; }指定是将 Microsoft Word 表单字段保留为 PDF 中的表单字段还是将其转换为文本。 默认为错误的.
PrettyFormat { get; set; }当真的，在适用的情况下漂亮的格式输出。 默认值为错误的.
ProgressCallback { get; set; }在保存文档期间调用并接受有关保存进度的数据。
override SaveFormat { get; set; }指定使用此保存选项对象时保存文档的格式。 只能是Pdf.
TempFolder { get; set; }指定保存到 DOC 或 DOCX 文件时使用的临时文件的文件夹。 默认情况下，此属性为无效的并且没有使用临时文件。
TextCompression { get; set; }指定用于文档中所有文本内容的压缩类型。
UpdateCreatedTimeProperty { get; set; }获取或设置一个值，确定是否CreatedTime属性在保存前更新。 默认值为错误的;
UpdateFields { get; set; }获取或设置一个值，确定在将文档保存为固定页面格式之前是否应更新某些类型的字段。 此属性的默认值为真的.
UpdateLastPrintedProperty { get; set; }获取或设置一个值，确定是否LastPrinted属性在保存前更新。
UpdateLastSavedTimeProperty { get; set; }获取或设置一个值，确定是否LastSavedTime属性在保存前更新。
UseAntiAliasing { get; set; }获取或设置一个值，确定是否使用抗锯齿进行渲染。
UseBookFoldPrintingSettings { get; set; }获取或设置一个布尔值，指示是否应使用小册子打印布局保存文档， 如果通过指定MultiplePages.
UseCoreFonts { get; set; }获取或设置一个值，确定是否用核心 PDF Type 1 字体替换 TrueType 字体 Arial、Times New Roman、 Courier New 和 Symbol。
UseHighQualityRendering { get; set; }获取或设置一个值，确定是否使用高质量（即慢速）渲染算法。
ZoomBehavior { get; set; }获取或设置一个值，该值确定使用 PDF 查看器打开文档时应应用哪种类型的缩放。
ZoomFactor { get; set; }获取或设置确定文档缩放系数（以百分比表示）的值。

方法

姓名描述
Clone()创建此对象的深度克隆。
override Equals(object)确定指定对象的值是否等于当前对象。

例子

演示如何使用保存选项属性更改图像颜色。

Document doc = new Document(MyDir + "Images.docx");

// 创建一个“PdfSaveOptions”对象，我们可以将其传递给文档的“Save”方法
// 修改该方法将文档转换为 .PDF 的方式。
// 将“ColorMode”属性设置为“Grayscale”，以黑白方式渲染文档中的所有图像。
// 使用此设置，输出文档的大小可能会更大。
// 将“ColorMode”属性设置为“Normal”，以彩色渲染所有图像。
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };

doc.Save(ArtifactsDir + "PdfSaveOptions.ColorRendering.pdf", pdfSaveOptions);

演示如何在将文档保存为 PDF 时应用文本压缩。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

for (int i = 0; i < 100; i++)
    builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, " +
                    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");

// 创建一个“PdfSaveOptions”对象，我们可以将其传递给文档的“Save”方法
// 修改该方法将文档转换为 .PDF 的方式。
PdfSaveOptions options = new PdfSaveOptions();

// 将“TextCompression”属性设置为“PdfTextCompression.None”以不应用任何内容
// 当我们将文档保存为 PDF 时压缩为文本。
// 将“TextCompression”属性设置为“PdfTextCompression.Flate”以应用 ZIP 压缩
// 当我们将文档保存为 PDF 时转换为文本。文档越大，产生的影响就越大。
options.TextCompression = pdfTextCompression;

doc.Save(ArtifactsDir + "PdfSaveOptions.TextCompression.pdf", options);

演示如何将整个文档转换为具有文档大纲三个级别的 PDF。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 插入 1 至 5 级标题。
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;

Assert.True(builder.ParagraphFormat.IsHeading);

builder.Writeln("Heading 1");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;

builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;

builder.Writeln("Heading 1.2.1");
builder.Writeln("Heading 1.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;

builder.Writeln("Heading 1.2.2.1");
builder.Writeln("Heading 1.2.2.2");

builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading5;

builder.Writeln("Heading 1.2.2.2.1");
builder.Writeln("Heading 1.2.2.2.2");

// 创建一个“PdfSaveOptions”对象，我们可以将其传递给文档的“Save”方法
// 修改该方法将文档转换为 .PDF 的方式。
PdfSaveOptions options = new PdfSaveOptions();

// 输出的 PDF 文档将包含一个大纲，它是列出文档正文中的标题的目录。
// 单击此大纲中的条目将带我们到达其各自标题的位置。
// 将“HeadingsOutlineLevels”属性设置为“4”，以从大纲中排除级别高于 4 的所有标题。
options.OutlineOptions.HeadingsOutlineLevels = 4;

// 如果大纲条目在其自身和相同或较低级别的下一个条目之间有更高级别的后续条目，
// 条目左侧将出现一个箭头。该条目是多个此类“子条目”的“所有者”。
// 在我们的文档中，第 5 级标题级别的大纲条目是第二个第 4 级大纲条目的子条目，
// 第 4 和第 5 标题级别条目是第二个 3 级别条目的子条目，依此类推。
// 在大纲中，我们可以单击“所有者”条目的箭头来折叠/展开其所有子条目。
// 将“ExpandedOutlineLevels”属性设置为“2”以自动展开所有标题级别 2 和较低的大纲条目
// 当我们打开文档时，折叠所有级别、3 级及更高级别的条目。
options.OutlineOptions.ExpandedOutlineLevels = 2;

doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);

也可以看看

PdfPermissions Enum PdfTextCompression Enum