PdfSaveOptions

PdfSaveOptions class

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

public class PdfSaveOptions : FixedPageSaveOptions

构造函数

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

特性

姓名	描述
AdditionalTextPositioning { get; set; }	一个标志，指定是否编写额外的文本定位操作符。
AllowEmbeddingPostScriptFonts { get; set; }	获取或设置一个布尔值，该值指示是否允许在保存文档中嵌入 TrueType 字体时使用 PostScript 轮廓嵌入字体。默认值为错误的.
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”标签以导出文本语言。
FlatOpcXmlMappingOnly { get; set; }	获取或设置值，确定允许映射哪些文档格式`XmlMapping`. 仅默认FlatOpc允许映射文档格式。
FontEmbeddingMode { get; set; }	指定字体嵌入模式。
HeaderFooterBookmarksExportMode { get; set; }	确定如何导出页眉/页脚中的书签。
ImageColorSpaceExportMode { get; set; }	指定如何为 PDF 文档中的图像选择色彩空间。
ImageCompression { get; set; }	指定用于文档中所有图像的压缩类型。
ImlRenderingMode { get; set; }	获取或设置一个值，确定如何呈现墨水 (InkML) 对象。
InterpolateImages { get; set; }	指示图像插值是否应由合格阅读器执行的标志。当`错误的`指定时，标志不会写入输出文档，会使用 reader 的默认行为。
JpegQuality { get; set; }	获取或设置确定 PDF 文档中 JPEG 图像质量的值。
MemoryOptimization { get; set; }	获取或设置值确定是否应在保存文档之前执行内存优化。此属性的默认值为错误的.
MetafileRenderingOptions { get; set; }	允许指定元文件渲染选项。
NumeralFormat { get; set; }	获取或设置`NumeralFormat`用于渲染数字。默认使用欧洲数字。
OpenHyperlinksInNewWindow { get; set; }	获取或设置一个值，该值确定是否强制在浏览器的新窗口（或选项卡）中打开输出 Pdf 文档中的超链接。
virtual OptimizeOutput { get; set; }	标志表示是否需要优化输出。如果设置了这个标志，多余的嵌套画布和空的画布被删除，也会连接具有相同格式的相邻字形。注意：内容显示的准确性可能会受到影响，如果此属性设置为 true。默认为 false。
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`属性在保存前更新。默认值为 false；
UpdateFields { get; set; }	获取或设置一个值，该值确定在将文档保存为固定页面格式之前是否应更新某些类型的字段。此属性的默认值为真的.
UpdateLastPrintedProperty { get; set; }	获取或设置一个值，确定是否`LastPrinted`属性在保存之前更新。
UpdateLastSavedTimeProperty { get; set; }	获取或设置一个值，确定是否`LastSavedTime`属性在保存之前更新。
UpdateSdtContent { get; set; }	获取或设置值确定内容是否`StructuredDocumentTag`在保存之前更新。
UseAntiAliasing { get; set; }	获取或设置一个值，确定是否使用抗锯齿进行渲染。
UseBookFoldPrintingSettings { get; set; }	获取或设置一个布尔值，指示是否应使用小册子打印布局保存文档，如果通过以下方式指定`MultiplePages`.
UseCoreFonts { get; set; }	获取或设置一个值，确定是否将 TrueType 字体 Arial、Times New Roman、 Courier New 和 Symbol 替换为核心 PDF Type 1 字体。
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 PdfTextCompression