Class PdfSaveOptions

Class PdfSaveOptions

名称: Aspose.Words.Saving 集合: Aspose.Words.dll (25.4.0)

可以用来指定额外的选项,当将文档保存到 Aspose.Words.SaveFormat.Pdf 格式时。

要了解更多,请参观 Specify Save Options 文档文章。

public class PdfSaveOptions : FixedPageSaveOptions

Inheritance

object SaveOptions FixedPageSaveOptions PdfSaveOptions

继承人

FixedPageSaveOptions.Equals(object) , FixedPageSaveOptions.AssertValidIdPrefix(string) , FixedPageSaveOptions.IsValidIdPrefix(string) , FixedPageSaveOptions.PageSet , FixedPageSaveOptions.PageSavingCallback , FixedPageSaveOptions.NumeralFormat , FixedPageSaveOptions.MetafileRenderingOptions , FixedPageSaveOptions.JpegQuality , FixedPageSaveOptions.ColorMode , FixedPageSaveOptions.OptimizeOutput , SaveOptions.CreateSaveOptions(SaveFormat) , SaveOptions.CreateSaveOptions(string) , SaveOptions.SaveFormat , SaveOptions.ExportGeneratorName , SaveOptions.TempFolder , SaveOptions.PrettyFormat , SaveOptions.UseAntiAliasing , SaveOptions.UseHighQualityRendering , SaveOptions.DmlRenderingMode , SaveOptions.DmlEffectsRenderingMode , SaveOptions.ImlRenderingMode , SaveOptions.DefaultTemplate , SaveOptions.UpdateFields , SaveOptions.UpdateLastSavedTimeProperty , SaveOptions.UpdateLastPrintedProperty , SaveOptions.UpdateCreatedTimeProperty , SaveOptions.MemoryOptimization , SaveOptions.UpdateAmbiguousTextFont , SaveOptions.Dml3DEffectsRenderingMode , SaveOptions.ProgressCallback , SaveOptions.AllowEmbeddingPostScriptFonts , SaveOptions.CustomTimeZoneInfo , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

PdfSaveOptions()

启动这个类的新例子,可以用来保存文档。Aspose.Words.SaveFormat.PDF格式。

public PdfSaveOptions()

Properties

AdditionalTextPositioning

一个旗帜,说明是否写额外的文本定位运营商。

public bool AdditionalTextPositioning { get; set; }

财产价值

bool

Remarks

如果 , 额外的文本定位操作员写到 PDF 输出. 这可能有助于克服一些打印机不准确的文字定义问题. 缺点是增加的PDF 文件大小。

默认值是。

AttachmentsEmbeddingMode

收到或设置一个值,确定附件如何嵌入到 PDF 文档。

public PdfAttachmentsEmbeddingMode AttachmentsEmbeddingMode { get; set; }

财产价值

PdfAttachmentsEmbeddingMode

Remarks

默认值是 Aspose.Words.Saving.PdfAttachmentsEmbeddingMode. 没有和附件不包含。

PDF/A-1、PDF / A-2 和常规的 PDF / a-4 (不适用于 PDF 或 A-4f) 标准不允许嵌入文件. Aspose.Words.Saving.PdfAttachmentsEmbeddingMode. 不会自动使用任何值。

CacheBackgroundGraphics

收到或设置一个值,确定是否要存储文档背景中的图形。

public bool CacheBackgroundGraphics { get; set; }

财产价值

bool

Remarks

默认值是,背景图像被写入 PDF 文档作为 xObject。

当值为背景图形时,不会被隐藏。

某些格式不支持加密(具有字段、图标、HRef的格言)。

文档背景图形是各式各样的形状、图表、在脚本或标题中放置的图像以及页面的背景和边界。

Compliance

指定输出文件的 PDF 标准遵守水平。

public PdfCompliance Compliance { get; set; }

财产价值

PdfCompliance

Remarks

默认情况是 Aspose.Words.Saving.PdfCompliance.Pdf17.

CreateNoteHyperlinks

指定是否在主要文本故事中将脚笔/endnote 引用转换为活跃的 hyperlinks.当点击时,将导致相应脚笔/endnote.Default 是“虚假”。

public bool CreateNoteHyperlinks { get; set; }

财产价值

bool

CustomPropertiesExport

获取或设置一个值,确定 Aspose.Words.Document.CustomDocumentProperties 如何出口到 PDF 文件。

public PdfCustomPropertiesExport CustomPropertiesExport { get; set; }

财产价值

PdfCustomPropertiesExport

Remarks

默认值是 Aspose.Words.Saving.PdfCustomPropertiesExport.None。

Aspose.Words.Saving.PdfCustomPropertiesExport.Metadata 值在保存到 PDF/A 时不受支持. Wl26. 保存. PDFCustomsPropertyExports.Standard 将用于代替 PDF / A-1 和 PDF - A - 2 以及 _ WL - 26_。

Aspose.Words.Saving.PdfCustomPropertiesExport.Standard 值在保存到 PDF 2.0 时不支持。

DigitalSignatureDetails

获取或设置输出PDF文件签名的详细信息。

public PdfDigitalSignatureDetails DigitalSignatureDetails { get; set; }

财产价值

PdfDigitalSignatureDetails

Remarks

当此属性设置为有效的 Aspose.Words.Saving.PdfDigitalSignatureDetails 对象时,则输出 PDF 文档将数字签名。

DisplayDocTitle

指示窗口的标题栏是否应该显示从文档信息词典的标题输入。

public bool DisplayDocTitle { get; set; }

财产价值

bool

Remarks

如果 , 标题栏应该显示包含文档的 PDF 文件的名称。

此旗是由 PDF/UA 符合要求的,值将自动用于保存到 PDF/UA 时。

默认值是。

DmlEffectsRenderingMode

收到或设置一个值,决定如何播放DrawingML效果。

public override DmlEffectsRenderingMode DmlEffectsRenderingMode { get; set; }

财产价值

DmlEffectsRenderingMode

Remarks

默认值是 Aspose.Words.Saving.DmlEffectsRenderingMode.Simplified。

此属性在文件出口到固定页面格式时使用。

如果 Aspose.Words.Saving.PdfSaveOptions.Compliance 设置为 Aspose.Words.Saving.PdfCompliance.PdfA1a 或 Aspose.Words.Saving.PdfCompliance.PdfA1b,属性总是返回 Aspose.Words.Saving.DmlEffectsRenderingMode.None。

DownsampleOptions

允许指定下例选项。

public DownsampleOptions DownsampleOptions { get; set; }

财产价值

DownsampleOptions

EmbedAttachments

收到或设置一个值,确定是否要嵌入附件到 PDF 文档。

[Obsolete("Obsolete, please use AttachmentsEmbeddingMode instead.")]
public bool EmbedAttachments { get; set; }

财产价值

bool

Remarks

默认值是,附件不包含。

当值是附件将嵌入到PDF文档中。

PDF/A-1、PDF/ A-2 和 PDF / A-4 (非 F 级别) 标准不允许嵌入文件。

嵌入附件不支持,当加密被启用时,值将自动使用。

EmbedFullFonts

检查字体如何嵌入到结果的 PDF 文件中。

public bool EmbedFullFonts { get; set; }

财产价值

bool

Remarks

默认值是 , 这意味着字体在插入之前被下载。 下载是有用的,如果你想保持输出文件大小较小。

当这个值设置为 , 一个完整的字体文件被嵌入到 PDF 没有订阅. 这将导致更大的输出文件,但可以是一个有用的选项,当你想编辑结果的 PDF 后来(例如,添加更多文本)。

某些字体是大(大兆比特),并将它们插入没有下载将导致大输出文件。

EncryptionDetails

获取或设置输出PDF文件加密的详细信息。

public PdfEncryptionDetails EncryptionDetails { get; set; }

财产价值

PdfEncryptionDetails

Remarks

默认值是,输出文档不会被加密. 当此属性设置为有效的 Aspose.Words.Saving.PdfEncryptionDetails 对象时,输出 PDF 文档将被加密。

AES-128 加密算法用于保存基于 PDF 1.7 的遵守(包括 PDF/UA-1) 加密算法用于保存基于 PDF 2.0 的遵守。

加密是由 PDF/A 遵守禁止的. 在保存到 PDF/A 时,此选项将被忽略。

Aspose.Words.Saving.PdfPermissions.ContentCopyForAccessibility 许可由 PDF/UA 遵守要求,如果输出文件被加密。

Aspose.Words.Saving.PdfPermissions.ContentCopyForAccessibility 许可证在 PDF 2.0 格式中被推翻。

ExportDocumentStructure

收到或设置一个值,确定是否出口文件结构。

public bool ExportDocumentStructure { get; set; }

财产价值

bool

Remarks

此值在保存到 PDF/A-1a、PDF / A-2a 和 PDF / UA-1 时被忽略,因为文档结构为此符合要求。

请注意,出口文件结构显著增加记忆消耗,尤其是大型文件。

ExportLanguageToSpanTag

收到或设置一个值,确定是否要在文档结构中创建“Span”标签以出口文本语言。

public bool ExportLanguageToSpanTag { get; set; }

财产价值

bool

Remarks

默认值是“长度”属性,并在页面内容流中附加到标记内容序列。

当值为“Span”标签时,为非默认语言的文本创建,并将“Lang”属性附加到此标记中。

此值在 Aspose.Words.Saving.PdfSaveOptions.ExportDocumentStructure 时被忽略。

ExportParagraphGraphicsToArtifact

收到或设置一个值,确定一个段落图像是否应该被标记为艺术品。

public bool ExportParagraphGraphicsToArtifact { get; set; }

财产价值

bool

Remarks

默认值是和段落图形(字幕,文本重点等)将被标记为“Span”在文档的逻辑结构。

当值是段落图表将被标记为“Artifact”。

此值在 Aspose.Words.Saving.PdfSaveOptions.ExportDocumentStructure 时被忽略。

FontEmbeddingMode

指定字体嵌入模式。

public PdfFontEmbeddingMode FontEmbeddingMode { get; set; }

财产价值

PdfFontEmbeddingMode

Remarks

默认值是 Aspose.Words.Saving.PdfFontEmbeddingMode.EmbedAll。

此设置仅适用于 ANSI (Windows-1252) 编码的文本,如果文档包含非 ANSI 文本,则将包含相应的字体,无论此设置如何。

PDF/A 和 PDF/UA 符合要求所有字体都必须嵌入. Aspose.Words.Saving.PdfFontEmbeddingMode.EmbedAll 值在保存到 PDF/A 和 PDF/UA 时将自动使用。

HeaderFooterBookmarksExportMode

确定头条/脚条中的图标是如何出口的。

public HeaderFooterBookmarksExportMode HeaderFooterBookmarksExportMode { get; set; }

财产价值

HeaderFooterBookmarksExportMode

Remarks

默认值是 Aspose.Words.Saving.HeaderFooterBookmarksExportMode.All。

此属性与 Aspose.Words.Saving.PdfSaveOptions.OutlineOptions 相结合使用。

ImageColorSpaceExportMode

指定如何在 PDF 文档中选择图像的颜色空间。

public PdfImageColorSpaceExportMode ImageColorSpaceExportMode { get; set; }

财产价值

PdfImageColorSpaceExportMode

Remarks

默认值是 Aspose.Words.Saving.PdfImageColorSpaceExportMode.Auto。

如果 Aspose.Words.Saving.PdfImageColorSpaceExportMode.SimpleCmyk 值是指定的,则 Wl26.Discover.pdfSaveOptions.imageCompression 选项被忽略并用于文档中的所有图像。

Aspose.Words.Saving.PdfImageColorSpaceExportMode.SimpleCmyk 值在保存到 PDF/A 时不支持。

ImageCompression

指定将用于文档中的所有图像的压缩类型。

public PdfImageCompression ImageCompression { get; set; }

财产价值

PdfImageCompression

Remarks

默认情况是 Aspose.Words.Saving.PdfImageCompression.Auto。

使用 Aspose.Words.Saving.PdfImageCompression.Jpeg 允许您通过 Aspose.Words.Saving.PdfSaveOptions.JpegQuality 属性控制输出文档中的图像质量。

使用 Aspose.Words.Saving.PdfImageCompression.Jpeg 提供与其他压缩类型的性能相比最快的转换速度,但在这种情况下,有损失的 JPEG 压缩。

使用 Aspose.Words.Saving.PdfImageCompression.Auto 允许通过 Aspose.Words.Saving.PdfSaveOptions.JpegQuality 属性控制输出文件中的 Jpeg 的质量,但对于其他格式,原始的像素数据被提取并存储在 Flate 压缩中。

InterpolateImages

旗帜表明图像中断是否应由符合的读者进行。当“虚假”被指定时,旗帜不会写入输出文件,而读者的默认行为则被用来代替。

public bool InterpolateImages { get; set; }

财产价值

bool

Remarks

当源图像的分辨率显著低于输出设备的,每个源样本覆盖了许多设备像素. 因此,图形可以看起来模糊或封锁。 这些视觉对象可以通过应用图标交换算法在拍摄过程中减少。 而不是绘制所有像头被一个相同的颜色的来源样品,图片交叉试图产生一个顺利的过渡之间接近的示例值。

遵守的读者可以选择不执行此 PDF 功能,或者可以使用他所希望的任何具体的互动实施。

默认值是。

Interpolation 旗是禁止 PDF/A 遵守的,值将自动用于保存到 PDF/A 时。

JpegQuality

获取或设置一个值,确定 PDF 文档中的 JPEG 图像的质量。

public int JpegQuality { get; set; }

财产价值

int

Remarks

默认值为100。

此属性与 Aspose.Words.Saving.PdfSaveOptions.ImageCompression 相结合使用。

只有在文件中包含 JPEG 图像时才有效。

使用此属性获取或设置文档内图像的质量,当存储在PDF格式时,值可能从0到100,其中0意味着最糟糕的质量,但最大压缩,100意味着最好的质量,但最低压缩。

OpenHyperlinksInNewWindow

收到或设置一个值,确定是否在输出PDF文档中的 hyperlinks被迫在浏览器的新窗口(或选项卡)中打开。

public bool OpenHyperlinksInNewWindow { get; set; }

财产价值

bool

Remarks

默认值是 . 当这个值设置到超链接时,使用 JavaScript 代码保存。

请注意,如果此选项设置为超链接,则可能不会在某些 PDF 阅读器中工作,例如 Chrome、Firefox。

通过 PDF/A-1 和 PDF/A-2 遵守,JavaScript 操作被禁止;在保存到 PDF/A-1 和 PDF/A-2 时将自动使用。

OutlineOptions

允许指定 outline 选项。

public OutlineOptions OutlineOptions { get; }

财产价值

OutlineOptions

Remarks

输出可以从标题和图标创建。

标题的输出级别由标题级别确定。

您可以设置将 max 标题级别纳入列表或完全禁用标题列表。

对于图标的输出级别,选项可以设置为所有图标的默认值或特定图标的单个值。

此外,输出可以通过使用相同的 Aspose.Words.Saving.PdfSaveOptions.OutlineOptions 类出口到 XPS 格式。

PageLayout

指定在 PDF 阅读器中打开文档时使用的页面布局。

public PdfPageLayout PageLayout { get; set; }

财产价值

PdfPageLayout

Remarks

默认值是 Aspose.Words.Saving.PdfPageLayout.SinglePage。

PageMode

说明 PDF 文档在 PDF 阅读器中打开时应该如何显示。

public PdfPageMode PageMode { get; set; }

财产价值

PdfPageMode

Remarks

默认值是 Aspose.Words.Saving.PdfPageMode.UseOutlines。

PreblendImages

获取或设置一个值,确定是否要混合透明的图像与黑色背景颜色。

public bool PreblendImages { get; set; }

财产价值

bool

Remarks

预混合图像可以改善 PDF 文档在 Adobe Reader 中的视觉外观,并删除反粘贴文档。

为了正确显示预混合图像,PDF浏览器应用程序必须支持 /Matte 输入在软面具图像词典。

默认值是。

PreserveFormFields

指定是否保存 Microsoft Word 表格字段作为表格字段在 PDF 或将其转换为 text.Default 是“假”。

public bool PreserveFormFields { get; set; }

财产价值

bool

Remarks

Microsoft Word 表格字段包括文本输入、下载和检查框控制。

当设置为 , 这些字段将作为文本出口到 PDF. 当设置为 , 这些字段将作为 PDF 表格字段出口。

当将表格字段出口到 PDF 作为表格字段时,可能会出现某些格式化损失,因为 PDF 表格字段不支持 Microsoft Word 表格字段的所有功能。

此外,输出大小取决于内容大小,因为Microsoft Word的可编辑表格是内线对象。

可编辑的表格被 PDF/A 遵守禁止,值在保存到 PDF/A 时将自动使用。

PDF/UA 存储时不支持表格字段,值将自动使用。

RenderChoiceFormFieldBorder

指定是否要提供 PDF 选项表格字段边界。

public bool RenderChoiceFormFieldBorder { get; set; }

财产价值

bool

Remarks

PDF 选择表格字段用于出口 SDT Combo Box 内容控制, SDT Drop-Down 列表内容控制和遗产 Drop-Down 表格字段,当 Aspose.Words.Saving.PdfSaveOptions.PreserveFormFields 选项被启用时。

默认值是。

SaveFormat

指定文档将存储的格式,如果使用此存储选项对象。只能是 Aspose.Words.SaveFormat.Pdf。

public override SaveFormat SaveFormat { get; set; }

财产价值

SaveFormat

TextCompression

指定要用于文档中的所有文本内容的压缩类型。

public PdfTextCompression TextCompression { get; set; }

财产价值

PdfTextCompression

Remarks

默认情况是 Aspose.Words.Saving.PdfTextCompression.Flate。

在保存文档时,输出大小显著增加,而无压缩。

UseBookFoldPrintingSettings

收到或设置一个 boolean 值,表明文档是否应该使用图表打印布局保存;如果它是通过 Aspose.Words.PageSetup.MultiplePages 指定。

public bool UseBookFoldPrintingSettings { get; set; }

财产价值

bool

Remarks

<p>

如果此选项是指定的, Aspose.Words.Saving.FixedPageSaveOptions.PageSet 在保存时被忽略。这种行为与MS Word相匹配。如果在页面设置中未列出书板打印设置,则此选项将无效。

UseCoreFonts

收到或设置一个值,确定是否取代 TrueType 字体 Arial, Times New Roman,Courier New and Symbol with core PDF Type 1 字体。

public bool UseCoreFonts { get; set; }

财产价值

bool

Remarks

当此值设置为 Arial、Times New Roman、Courier New 和 Symbol 字体时,在 PDF 文档中将相应的核心字体 Type 1 替换为字体。

核心 PDF 字体,或其字体测量和适当的替代字体,必须可用于任何 PDF 浏览器应用程序。

此设置仅适用于 ANSI (Windows-1252) 编码的文本. 非 ANSI 文本将使用内置的 TrueType 字体,无论此设置如何。

PDF/A 和 PDF/UA 符合要求所有字体都内置。值将自动用于保存到 PDF/A 和 PDF/UA 时。

在保存到 PDF 2.0 格式时,核心字体不支持;在保存到 PDF 2.0 时,值将自动使用。

此选项具有更高的优先事项,然后是 Aspose.Words.Saving.PdfSaveOptions.FontEmbeddingMode 选项。

UseSdtTagAsFormFieldName

指定是否使用 SDT 控制标签或 ID 属性作为 PDF 中的表格字段名称。

public bool UseSdtTagAsFormFieldName { get; set; }

财产价值

bool

Remarks

默认值是。

当设置到 , SDT 控制 ID 属性被用作 PDF 中的表格字段名称。

当设置到 , SDT 控制标签属性被用作 PDF 中的表格字段名称。

如果设置到和标签是空的,ID属性将被用作表格字段名称。

如果设置到和标签值不单一,将重复标签值更改为创建独特的 PDF 表格字段名称。

ZoomBehavior

获取或设置一个值,确定在使用 PDF 浏览器打开文档时应应用什么类型的聚焦。

public PdfZoomBehavior ZoomBehavior { get; set; }

财产价值

PdfZoomBehavior

Remarks

默认值是 Aspose.Words.Saving.PdfZoomBehavior.None,即不适用。

ZoomFactor

收到或设置一个值,确定一个文档的聚焦因素(百分比)。

public int ZoomFactor { get; set; }

财产价值

int

Remarks

此值仅适用于 Aspose.Words.Saving.PdfSaveOptions.ZoomBehavior 设置为 Aspose.Words.Saving.PdfZoomBehavior.ZoomFactor。

Methods

Clone()

创建这个对象的深度克隆。

public PdfSaveOptions Clone()

Returns

PdfSaveOptions

 中文