Class PdfSaveOptions
Nome do espaço: Aspose.Words.Saving Assembleia: Aspose.Words.dll (25.4.0)
Pode ser usado para especificar opções adicionais ao salvar um documento no formato Aspose.Words.SaveFormat.Pdf.
Para saber mais, visite o Specify Save Options Artigo de Documentação.
public class PdfSaveOptions : FixedPageSaveOptionsInheritance
object ← SaveOptions ← FixedPageSaveOptions ← PdfSaveOptions
Membros herdados
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()
Inicia uma nova instância desta classe que pode ser usada para salvar um documento noFormato de arquivo.Words.SaveFormat.Pdf
public PdfSaveOptions()Properties
AdditionalTextPositioning
Uma bandeira especificando se escrever outros operadores de posicionamento de texto ou não.
public bool AdditionalTextPositioning { get; set; }Valor da propriedade
Remarks
Se, operadores adicionais de posicionamento de texto são escritos para a saída do PDF. Isso pode ajudar a superar problemas com a posição incorrecta do texto com algumas impressoras.
O valor padrão é.
AttachmentsEmbeddingMode
Recebe ou coloca um valor que determina como os anexos são inseridos no documento PDF.
public PdfAttachmentsEmbeddingMode AttachmentsEmbeddingMode { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfAttachmentsEmbeddingMode.Nenhum e os anexos não são incorporados.
Os padrões PDF/A-1, PDF-A-2 e regulares PDF / A-4 (não pdf / a-4f) não permitem arquivos incorporados. Aspose.Words.Saving.PdfAttachmentsEmbeddingMode.Não será utilizado nenhum valor automaticamente.
CacheBackgroundGraphics
Obter ou definir um valor que determina se ou não cache gráficos colocados no fundo do documento.
public bool CacheBackgroundGraphics { get; set; }Valor da propriedade
Remarks
O valor padrão é e os gráficos de fundo são escritos no documento PDF como um xObject.
Quando o valor é gráficos de fundo não são cache.
Algumas formas não são suportadas para caching (formas com campos, bookmarks, HRefs).
O gráfico de fundo do documento é uma variedade de formas, gráficos, imagens colocadas no footer ou cabeçalho, bem como o background e o limite de uma página.
Compliance
Determina o nível de conformidade com os padrões PDF para os documentos de saída.
public PdfCompliance Compliance { get; set; }Valor da propriedade
Remarks
O padrão é Aspose.Words.Saving.PdfCompliance.Pdf17.
CreateNoteHyperlinks
Determina se para converter referências footnote/endnote na história de texto principal em hiperlinks ativos.Quando clicado o hiperlink vai levar ao correspondente footnote/endnote.Default é ‘falso’.
public bool CreateNoteHyperlinks { get; set; }Valor da propriedade
CustomPropertiesExport
Obter ou definir um valor determinando como Aspose.Words.Document.CustomDocumentProperties são exportados para o arquivo PDF.
public PdfCustomPropertiesExport CustomPropertiesExport { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfCustomPropertiesExport.None.
Aspose.Words.Saving.PdfCustomPropertiesExport.Metadata valor não é suportado quando você salvar para PDF/A. Wl26.Salvamento.PDFCustomsPropertyExports.Standard será usado em vez de PDF / A-1 e PDF - A-2 e __ WL26.Salva-se.
Aspose.Words.Saving.PdfCustomPropertiesExport.Valor padrão não é suportado quando você salvar para PDF 2.0. Wl26.Metadata será usado em vez disso.
DigitalSignatureDetails
Recebe ou coloca os detalhes para assinar o documento de saída PDF.
public PdfDigitalSignatureDetails DigitalSignatureDetails { get; set; }Valor da propriedade
Remarks
O valor padrão é e o documento de saída não será assinado.Quando esta propriedade é configurada para um objeto válido Aspose.Words.Saving.PdfDigitalSignatureDetails, então o documento de saída PDF será digitalmente assinado.
DisplayDocTitle
Uma bandeira que especifique se a barra de título da janela deve exibir o título do documentoA entrada do título do dicionário de informação do documento.
public bool DisplayDocTitle { get; set; }Valor da propriedade
Remarks
Se, a barra de título deverá, em vez disso, exibir o nome do arquivo PDF que contém o documento.
Esta bandeira é exigida pela conformidade PDF/UA. o valor será usado automaticamente ao salvar para PDF/UA.
O valor padrão é.
DmlEffectsRenderingMode
Obter ou definir um valor que determina como os efeitos DrawingML são renderizados.
public override DmlEffectsRenderingMode DmlEffectsRenderingMode { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.DmlEffectsRenderingMode.Simplified.
Esta propriedade é usada quando o documento é exportado para formatos de página fixos.
Se Aspose.Words.Saving.PdfSaveOptions.Compliance é configurado para Aspose.Words.Saving.PdfCompliance.PdfA1a ou Aspose.Words.Saving.PdfCompliance.PdfA1b, a propriedade sempre retorna Aspose.Words.Saving.DmlEffectsRenderingMode.None.
DownsampleOptions
Permite especificar opções de descenso.
public DownsampleOptions DownsampleOptions { get; set; }Valor da propriedade
EmbedAttachments
Obter ou definir um valor que determina se ou não incorporar anexos ao documento PDF.
[Obsolete("Obsolete, please use AttachmentsEmbeddingMode instead.")]
public bool EmbedAttachments { get; set; }Valor da propriedade
Remarks
O valor padrão é e os anexos não são incorporados.
Quando o valor é, os anexos são inseridos no documento PDF.
Os padrões PDF/A-1 e PDF / A-2 (não nível F) não permitem arquivos incorporados. valor será usado automaticamente.
Os anexos incorporados não são suportados quando a criptografia é ativada. valor será usado automaticamente.
EmbedFullFonts
Verifica como as letras são inseridas nos documentos PDF resultantes.
public bool EmbedFullFonts { get; set; }Valor da propriedade
Remarks
O valor padrão é , o que significa que as letras são subsetadas antes de inserir. Subseting é útil se você quiser manter o tamanho do arquivo de saída menor.
Quando este valor é configurado para , um arquivo de fonte completo é inserido em PDF sem subscrição. Isso resultará em arquivos de saída maiores, mas pode ser uma opção útil quando você deseja editar o resultado PDF mais tarde (por exemplo, adicionar mais texto).
Algumas letras são grandes (mega-bits) e incorporá-las sem subscrição resultará em grandes documentos de saída.
EncryptionDetails
Recebe ou coloca os detalhes para criptografar o documento de saída PDF.
public PdfEncryptionDetails EncryptionDetails { get; set; }Valor da propriedade
Remarks
O valor padrão é e o documento de saída não será criptografado.Quando esta propriedade é configurada para um objeto válido Aspose.Words.Saving.PdfEncryptionDetails, então o documento de saída PDF será criptografado.
O algoritmo de criptografia AES-128 é usado para salvar a conformidade baseada em PDF 1.7 (incluindo PDF/UA-1).
A criptografia é proibida pela conformidade do PDF/A. Esta opção será ignorada ao salvar para o PDF/A.
Aspose.Words.Saving.PdfPermissions.ContentCopyForAcessibilidade permissão é exigida pela conformidade PDF/UA se o documento de saída é criptografado.
Aspose.Words.Saving.PdfPermissions.ContentCopyForAcessibilidade permissão é depreciada em formato PDF 2.0.
ExportDocumentStructure
Obter ou definir um valor que determina se ou não exportar estrutura de documento.
public bool ExportDocumentStructure { get; set; }Valor da propriedade
Remarks
Este valor é ignorado quando é salvo em PDF/A-1a, PDF / A-2a e pdf / UA-1 porque a estrutura do documento é necessária para essa conformidade.
Observe que exportar a estrutura do documento aumenta significativamente o consumo de memória, especialmente para os grandes documentos.
ExportLanguageToSpanTag
Obter ou definir um valor que determina se criar ou não uma etiqueta “Span” na estrutura do documento para exportar a linguagem de texto.
public bool ExportLanguageToSpanTag { get; set; }Valor da propriedade
Remarks
O valor padrão é e o atributo “Lang” é anexado a uma sequência de conteúdo marcado em um fluxo de conteúdos de página.
Quando o valor é “Span”, a tag é criada para o texto com linguagem não-default e o atributo “Lang” é anexado a esta tag.
Este valor é ignorado quando Aspose.Words.Saving.PdfSaveOptions.ExportDocumentStructure é .
ExportParagraphGraphicsToArtifact
Recebe ou coloca um valor que determina se um gráfico de parágrafo deve ser marcado como um artefato.
public bool ExportParagraphGraphicsToArtifact { get; set; }Valor da propriedade
Remarks
O valor padrão é e gráficos de parágrafos (sublinhas, ênfase de texto, etc.) serão marcados como “Span” na estrutura lógica do documento.
Quando o valor é o gráfico do parágrafo será marcado como “Artifact”.
Este valor é ignorado quando Aspose.Words.Saving.PdfSaveOptions.ExportDocumentStructure é .
FontEmbeddingMode
Determina o modo de inserção de letra.
public PdfFontEmbeddingMode FontEmbeddingMode { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfFontEmbeddingMode.EmbedAll.
Esta configuração só funciona para o texto em codificação ANSI (Windows-1252). se o documento contém texto não-ANSI, então as letras correspondentes serão inseridas independentemente desta configuração.
A conformidade com PDF/A e PDF/UA exige que todas as letras sejam incorporadas. Aspose.Words.Saving.PdfFontEmbeddingMode.EmbedTodos os valores serão utilizados automaticamente ao salvar para PDF/A e PDF/UA.
HeaderFooterBookmarksExportMode
Determina como são exportadas as notas em cabeçalhos/footers.
public HeaderFooterBookmarksExportMode HeaderFooterBookmarksExportMode { get; set; }Valor da propriedade
HeaderFooterBookmarksExportMode
Remarks
O valor padrão é Aspose.Words.Saving.HeaderFooterBookmarksExportMode.All.
Esta propriedade é usada em conjunto com a opção Aspose.Words.Saving.PdfSaveOptions.OutlineOptions.
ImageColorSpaceExportMode
Determina como o espaço de cores será selecionado para as imagens no documento PDF.
public PdfImageColorSpaceExportMode ImageColorSpaceExportMode { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfImageColorSpaceExportMode.Auto.
Se o valor Aspose.Words.Saving.PdfImageColorSpaceExportMode.SimpleCmyk for especificado, a opção de compressão da imagem é ignorada e a composição Flate é usada para todas as imagens no documento.
Aspose.Words.Saving.PdfImageColorSpaceExportMode.SimpleCmyk valor não é suportado quando você salvar para PDF/A. Wl26.Salvar.FdfImagicColorspaceexport.Auto valor será usado em vez disso.
ImageCompression
Determina o tipo de compressão a ser usado para todas as imagens no documento.
public PdfImageCompression ImageCompression { get; set; }Valor da propriedade
Remarks
O padrão é Aspose.Words.Saving.PdfImageCompression.Auto.
Usando Aspose.Words.Saving.PdfImageCompression.Jpeg permite que você controle a qualidade das imagens no documento de saída através da propriedade Aspose.Words.Saving.PdfSaveOptions.JpegQuality.
Usando Aspose.Words.Saving.PdfImageCompression.Jpeg fornece a velocidade de conversão mais rápida quando comparado com o desempenho de outros tipos de compressão, mas neste caso, há perda de compressão JPEG.
Usando Aspose.Words.Saving.PdfImageCompression.Auto permite controlar a qualidade de Jpeg no documento de saída através da propriedade Aspose.Words.Saving.PdfSaveOptions.JpegQuality, mas para outros formatos, os dados de pixel crus são extraídos e salvos com compressão Flate.
InterpolateImages
Uma bandeira que indica se a interpolação da imagem deve ser realizada por um leitor de conformidade.Quando ‘falso’ é especificado, a bandeira não é escrita no documento de saída e o comportamento padrão do leitor é usado em vez disso.
public bool InterpolateImages { get; set; }Valor da propriedade
Remarks
Quando a resolução de uma imagem fonte é significativamente menor do que a do dispositivo de saída, cada amostra fonte cobre muitos pixels de dispositivo. Como resultado, as imagens podem parecer longas ou bloqueadas. Esses artefatos visuais podem ser reduzidos aplicando um algoritmo de interpolação da imagem durante a renderização. Em vez de pintar todos os píxeles cobertos por um sample fonte com a mesma cor, a interpolagem imagem tente produzir uma transição suave entre os valores da mostra adjacente.
Um leitor de conformidade pode optar por não implementar esta função do PDF, ou pode usar qualquer implementação específica de interpolação que desejar.
O valor padrão é.
A bandeira de interpolação é proibida pela conformidade PDF/A. o valor será usado automaticamente quando salvo em PDF/A.
JpegQuality
Obter ou definir um valor que determina a qualidade das imagens JPEG dentro do documento PDF.
public int JpegQuality { get; set; }Valor da propriedade
Remarks
O valor padrão é 100.
Esta propriedade é usada em conjunto com a opção Aspose.Words.Saving.PdfSaveOptions.ImageCompression.
Ele só funciona quando um documento contém imagens JPEG.
Use esta propriedade para obter ou definir a qualidade das imagens dentro de um documento quando armazenado em formato PDF. O valor pode variar de 0 a 100, onde 0 significa a pior qualidade, mas compressão máxima e 100 significa a melhor qualidade, mas compressão mínima. Se a qualidade é 100 e a imagem fonte é JPEG, isso significa não compressão - bits originais serão salvos.
OpenHyperlinksInNewWindow
Obter ou definir um valor determinando se os hiperlinks no documento de saída PDFsão forçados a ser abertos em uma nova janela (ou tab) de um navegador.
public bool OpenHyperlinksInNewWindow { get; set; }Valor da propriedade
Remarks
O valor padrão é . Quando este valor é configurado para os hiperlinks são salvos usando o código JavaScript.
Observe que se esta opção for configurada para hiperligações não pode funcionar em alguns leitores de PDF, por exemplo, Chrome, Firefox.
As ações do JavaScript são proibidas pela conformidade do PDF/A-1 e do PDF/A-2. serão utilizadas automaticamente ao salvar para o PDF/A-1 e o PDF/A-2.
OutlineOptions
Permite especificar opções de outline.
public OutlineOptions OutlineOptions { get; }Valor da propriedade
Remarks
As entradas podem ser criadas a partir de títulos e bookmarks.
Para os títulos, o nível de saída é determinado pelo nível de título.
É possível definir o nível de cabeçalho máximo para ser incluído em listas de cabeçalho ou desabilitar listas de cabeçalho em tudo.
Para o nível de saída das notas, as opções podem ser definidas como um valor padrão para todas as notas ou como valores individuais para determinadas notas.
Além disso, as saídas podem ser exportadas para o formato XPS usando a mesma classe Aspose.Words.Saving.PdfSaveOptions.OutlineOptions.
PageLayout
Especifica o layout da página a ser usado quando o documento é aberto em um leitor PDF.
public PdfPageLayout PageLayout { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfPageLayout.SinglePage.
PageMode
Determina como o documento PDF deve ser exibido quando aberto em um leitor PDF.
public PdfPageMode PageMode { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfPageMode.UseOutlines.
PreblendImages
Recebe ou coloca um valor que determina se ou não confundir imagens transparentes com a cor de fundo preto.
public bool PreblendImages { get; set; }Valor da propriedade
Remarks
A mistura de imagens pode melhorar a aparência visual do documento PDF no Adobe Reader e remover artefatos anti-alias.
Para exibir adequadamente imagens premexidas, o aplicativo do visualizador PDF deve suportar /Matte entrada no dicionário de imagem soft-mask. Também imagens premexidas podem diminuir o desempenho de renderização PDF.
O valor padrão é.
PreserveFormFields
Determina se preservar campos de formulário do Microsoft Word como campos de formulário em PDF ou convertê-los em texto.Default é ‘falso’.
public bool PreserveFormFields { get; set; }Valor da propriedade
Remarks
Os campos de formulário do Microsoft Word incluem entrada de texto, descida e controle de caixa.
Quando configurado para , esses campos serão exportados como texto para PDF. Quando configurado para , esses campos serão exportados como campos de formulário PDF.
Ao exportar campos de formulário para PDF como campos de formulário, algumas perdas de formatação podem ocorrer porque os campos de formulário PDF não suportam todas as características dos campos de formulário do Microsoft Word.
Além disso, o tamanho da saída depende do tamanho do conteúdo porque os formulários editáveis no Microsoft Word são objetos inline.
Formulários editáveis são proibidos pela conformidade PDF/A. o valor será usado automaticamente quando salvo em PDF/A.
Os campos de formulário não são suportados quando você salvar para PDF/UA. o valor será usado automaticamente.
RenderChoiceFormFieldBorder
Determina se fazer o formato de seleção de PDF limite de campo.
public bool RenderChoiceFormFieldBorder { get; set; }Valor da propriedade
Remarks
Os campos de formulário de escolha do PDF são usados para exportar SDT Combo Box Content Control, SDT Drop-Down List Content Control e Legacy Drop-Down Form Field quando a opção Aspose.Words.Saving.PdfSaveOptions.PreserveFormFields é ativada.
O valor padrão é.
SaveFormat
Determina o formato em que o documento será salvo se este objeto de opções de salvo for usado.Só pode ser Aspose.Words.SaveFormat.Pdf.
public override SaveFormat SaveFormat { get; set; }Valor da propriedade
TextCompression
Determina o tipo de compressão a ser usado para todos os conteúdos textuais no documento.
public PdfTextCompression TextCompression { get; set; }Valor da propriedade
Remarks
O padrão é Aspose.Words.Saving.PdfTextCompression.Flate.
Ele aumenta significativamente o tamanho de saída quando salva um documento sem compressão.
UseBookFoldPrintingSettings
Recebe ou coloca um valor booleano indicando se o documento deve ser salvo usando um layout de impressão de folhetos,Se for especificado através de Aspose.Words.PageSetup.MultiplePages.
public bool UseBookFoldPrintingSettings { get; set; }Valor da propriedade
Remarks
<p>Se esta opção for especificada, Aspose.Words.Saving.FixedPageSaveOptions.PageSet é ignorado ao economizar.Este comportamento corresponde ao MS Word.Se as configurações de impressão do livro não forem especificadas na configuração da página, esta opção não terá efeito.
UseCoreFonts
Obter ou definir um valor que determina se ou não substituir as letras TrueType Arial, Times New Roman,Correio Novo e Símbolo com fonts de núcleo PDF Tipo 1.
public bool UseCoreFonts { get; set; }Valor da propriedade
Remarks
Quando este valor é configurado para Arial, Times New Roman, Courier New e Symbol fonts são substituídos em um documento PDF com a correspondente fonte de núcleo Tipo 1.
Fontes PDF essenciais, ou suas metricas de fontes e fontes de substituição apropriadas, são necessários para estar disponíveis para qualquer aplicação de visualizador de PDF.
Esta configuração só funciona para o texto em ANSI (Windows-1252) codificação. texto não-ANSI será escrito com fonte TrueType incorporado independentemente desta configuração.
A conformidade com PDF/A e PDF/UA exige que todas as letras sejam incorporadas. o valor será usado automaticamente ao salvar para PDF/A e PDF/UA.
Fontes essenciais não são suportados quando você salvar para o formato PDF 2.0. o valor será usado automaticamente quando você salvar para o formato PDF 2.0.
Esta opção tem uma prioridade maior então Aspose.Words.Saving.PdfSaveOptions.FontEmbeddingMode opção.
UseSdtTagAsFormFieldName
Determina se usar a propriedade Tag ou ID de controle SDT como um nome de campo de formulário em PDF.
public bool UseSdtTagAsFormFieldName { get; set; }Valor da propriedade
Remarks
O valor padrão é.
Quando configurado para , a propriedade de ID de controle SDT é usada como um nome do campo de formulário em PDF.
Quando configurado para , a propriedade SDT control Tag é usada como um nome do campo de formulário em PDF.
Se configurado para e Tag é vazio, a propriedade ID será usada como um nome de campo de formulário.
Se os valores definidos e marcados não forem únicos, os valores duplicados de marcados serão alterados para criar nomes de campos de formulário PDF únicos.
ZoomBehavior
Obter ou definir um valor que determina o tipo de zoom que deve ser aplicado quando um documento é aberto com um visualizador PDF.
public PdfZoomBehavior ZoomBehavior { get; set; }Valor da propriedade
Remarks
O valor padrão é Aspose.Words.Saving.PdfZoomBehavior.None, ou seja, nenhuma adaptação é aplicada.
ZoomFactor
Obter ou definir um valor que determina o factor de zoom (em porcentagem) para um documento.
public int ZoomFactor { get; set; }Valor da propriedade
Remarks
Este valor só é usado se Aspose.Words.Saving.PdfSaveOptions.ZoomBehavior for configurado para Aspose.Words.Saving.PdfZoomBehavior.ZoomFactor.
Methods
Clone()
Cria um clone profundo deste objeto.
public PdfSaveOptions Clone()