PdfSaveOptions

PdfSaveOptions class

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

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

public class PdfSaveOptions : FixedPageSaveOptions

构造函数

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

特性

姓名	描述
AdditionalTextPositioning { get; set; }	指定是否写入附加文本定位运算符的标志。
AllowEmbeddingPostScriptFonts { get; set; }	获取或设置一个布尔值，指示在保存文档时嵌入 TrueType 字体时是否允许嵌入带有 PostScript 轮廓的字体。默认值为`错误的`.
AttachmentsEmbeddingMode { get; set; }	获取或设置一个值，确定附件如何嵌入到 PDF 文档中。
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; }	允许指定下采样选项。
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; }	允许指定轮廓选项。
PageLayout { get; set; }	指定在 PDF 阅读器中打开文档时使用的页面布局。
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; }	在保存文档期间调用并接受有关保存进度的数据。
RenderChoiceFormFieldBorder { get; set; }	指定是否呈现 PDF 选择表单字段边框。
override SaveFormat { get; set; }	指定如果使用此保存选项对象，文档将以哪种格式保存。只能是Pdf.
TempFolder { get; set; }	指定保存为 DOC 或 DOCX 文件时使用的临时文件的文件夹。默认情况下，此属性为`无效的`并且不使用临时文件。
TextCompression { get; set; }	指定用于文档中所有文本内容的压缩类型。
UpdateAmbiguousTextFont { 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; }	获取或设置一个值，确定是否使用高质量（即慢速）渲染算法。
UseSdtTagAsFormFieldName { get; set; }	指定是否使用 SDT 控件标签或 Id 属性作为 PDF 中表单字段的名称。
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