Class PdfSaveOptions
Nom dels espais: Aspose.Words.Saving Assemblea: Aspose.Words.dll (25.4.0)
Es pot utilitzar per especificar opcions addicionals quan emmagatzema un document en el format Aspose.Words.SaveFormat.Pdf.
Per saber-ne més, visita el Specify Save Options Article de documentació.
public class PdfSaveOptions : FixedPageSaveOptionsInheritance
object ← SaveOptions ← FixedPageSaveOptions ← PdfSaveOptions
Membres heretats
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()
Inicialitza una nova instància d’aquesta classe que es pot utilitzar per salvar un document en elEl format de l’apartat.com és el format PDF.
public PdfSaveOptions()Properties
AdditionalTextPositioning
Una bandera que especifiqui si escriure més operadors de posicionament de text o no.
public bool AdditionalTextPositioning { get; set; }Valor de la propietat
Remarks
Si , els operadors de posicionament de text addicionals s’escriuen a la sortida PDF. Això pot ajudar a superar problemes amb la posició inexacta del text amb algunes impressores.
El valor defectuós és .
AttachmentsEmbeddingMode
Obté o s’estableix un valor que determina com s’incorporen els annexos al document PDF.
public PdfAttachmentsEmbeddingMode AttachmentsEmbeddingMode { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfAttachmentsEmbeddingMode.Ningú i els annexos no estan incorporats.
Els estàndards PDF/A-1, PDF / A-2 i regulars PDF-A-4 (no pdf/ A-4f) no permeten arxius embedded. Aspose.Words.Saving.PdfAttachmentsEmbeddingMode.No s’utilitzarà automàticament cap valor.
CacheBackgroundGraphics
Obté o s’estableix un valor que determina si o no cache els gràfics col·locats en el fons del document.
public bool CacheBackgroundGraphics { get; set; }Valor de la propietat
Remarks
El valor estàndard és i els gràfics de fons s’escriuen al document PDF com a xObject.
Quan el valor és gràfics de fons no es cache.
Algunes formes no es donen suport per al caching (formes amb camps, marcadors, HRefs).
El gràfic de fons del document és una varietat de formes, diagrams, imatges col·locades en el footer o el títol, així com el fons i la frontera d’una pàgina.
Compliance
Especifica el nivell de compliment de les normes PDF per als documents de sortida.
public PdfCompliance Compliance { get; set; }Valor de la propietat
Remarks
Per defecte és Aspose.Words.Saving.PdfCompliance.Pdf17.
CreateNoteHyperlinks
Especifica si convertir les referències de la nota/endnote en la història de text principal en hiperenllaços actius.Quan es cliqui l’hiperenllaç portarà a la nota/endnote corresponent.Default és ‘falsa’.
public bool CreateNoteHyperlinks { get; set; }Valor de la propietat
CustomPropertiesExport
Obté o estableix un valor que determina com Aspose.Words.Document.CustomDocumentProperties s’exporten al fitxer PDF.
public PdfCustomPropertiesExport CustomPropertiesExport { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfCustomPropertiesExport.None.
Aspose.Words.Saving.PdfCustomPropertiesExport.El valor de metadades no es dóna suport quan s’emmagatzema a PDF/A. Wl26.Salvació.FdFcPropartiesExtract.Standard serà utilitzat en lloc de PDF / A-1 i PDF -A-2 i _wl26.Salvat.
Aspose.Words.Saving.PdfCustomPropertiesExport.Valor estàndard no es dóna suport quan s’emmagatzema a PDF 2.0. Wl26.Descobrir.
DigitalSignatureDetails
Obté o estableix els detalls per signar el document PDF de sortida.
public PdfDigitalSignatureDetails DigitalSignatureDetails { get; set; }Valor de la propietat
Remarks
El valor estàndard és i el document de sortida no serà signat. Quan aquesta propietat s’estableix a un objecte d’Aspose.Words.Saving.PdfDigitalSignatureDetails vàlid, llavors el document de sortida PDF serà signat digitalment.
DisplayDocTitle
Una bandera que especifiqui si la barra de títol de la finestra ha de mostrar el títol del documentTítol d’entrada del diccionari de la informació del document.
public bool DisplayDocTitle { get; set; }Valor de la propietat
Remarks
En cas contrari, la barra de títol ha de mostrar el nom del fitxer PDF que conté el document.
Aquesta bandera es requereix per la conformitat PDF/UA. valor s’utilitzarà automàticament quan s’emmagatzema en PDF/UA.
El valor defectuós és .
DmlEffectsRenderingMode
Obté o estableix un valor que determina com es realitzen els efectes de DrawingML.
public override DmlEffectsRenderingMode DmlEffectsRenderingMode { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.DmlEffectsRenderingMode.Simplified.
Aquesta propietat s’utilitza quan el document s’exporta a formats de pàgina fixos.
Si Aspose.Words.Saving.PdfSaveOptions.Compliance es configura a Aspose.Words.Saving.PdfCompliance.PdfA1a o Aspose.Words.Saving.PdfCompliance.PdfA1b, la propietat sempre torna Aspose.Words.Saving.DmlEffectsRenderingMode.None.
DownsampleOptions
Permet especificar les opcions de descàrrega.
public DownsampleOptions DownsampleOptions { get; set; }Valor de la propietat
EmbedAttachments
Obté o s’estableix un valor que determina si s’incorporen adjunts al document PDF o no.
[Obsolete("Obsolete, please use AttachmentsEmbeddingMode instead.")]
public bool EmbedAttachments { get; set; }Valor de la propietat
Remarks
El valor defectuós és i els annexos no s’incorporen.
Quan el valor és, els annexos s’incorporen al document PDF.
Les normes PDF/A-1, PDF / A-2 i PDF (no nivell F) no permeten els fitxers incorporats. valor s’utilitzarà automàticament.
Els annexos incorporats no es recolzen quan s’activa la xifra. valor s’utilitzarà automàticament.
EmbedFullFonts
Controlar com s’incorporen fonts en els resultats documents PDF.
public bool EmbedFullFonts { get; set; }Valor de la propietat
Remarks
El valor estàndard és , el que significa que les fonts són subsetats abans d’incorporar. Subset és útil si voleu mantenir la mida de fitxer de sortida més petita.
Quan s’estableix aquest valor, un arxiu de font complet s’incorpora en PDF sense subscripció. Això resultarà en arxius de sortida més grans, però pot ser una opció útil quan voleu editar el resultat PDF més tard (per exemple, afegir més text).
Algunes fonts són grans (severals megabits) i incorporar-los sense subscripció resultarà en grans documents de sortida.
EncryptionDetails
Obté o estableix els detalls per a xifrar el document PDF de sortida.
public PdfEncryptionDetails EncryptionDetails { get; set; }Valor de la propietat
Remarks
El valor estàndard és i el document de sortida no es criptarà. Quan aquesta propietat s’estableix a un objecte Valid Aspose.Words.Saving.PdfEncryptionDetails, llavors el document de sortida PDF es criptar.
L’algoritme de criptació AES-128 s’utilitza en l’estalvi de conformitat basada en PDF 1.7 (inclòs PDF/UA-1). l’algoritme de criptació AES-256 s’utilitza en l’estalvi de conformitat basada en PDF 2.0.
La xifració està prohibida per la conformitat PDF/A. Aquesta opció s’ignorarà quan s’emmagatzema en PDF/A.
Aspose.Words.Saving.PdfPermissions.ContentCopyForAccessibilitat permís es requereix per la conformitat PDF/UA si el document de sortida és xifrat.
Aspose.Words.Saving.PdfPermissions.ContentCopyForAccessibilitat permís es deprecia en format PDF 2.0.
ExportDocumentStructure
Obté o estableix un valor que determina si exportar la estructura del document o no.
public bool ExportDocumentStructure { get; set; }Valor de la propietat
Remarks
Aquest valor es ignora quan s’emmagatzema en PDF/A-1a, PDF / A-2a i PDF (UA-1) perquè la estructura del document és necessària per a aquest compliment.
Tingueu en compte que exportar la estructura del document augmenta significativament el consum de memòria, especialment per als documents grans.
ExportLanguageToSpanTag
Obté o estableix un valor que determina si crear o no una etiqueta “Span” en l’estructura del document per exportar el llenguatge de text.
public bool ExportLanguageToSpanTag { get; set; }Valor de la propietat
Remarks
El valor estàndard és i l’atribute “Long” s’afegeix a una seqüència de continguts marcats en un flux de contingut de la pàgina.
Quan el valor és “Span” es crea per al text amb un llenguatge no estàndard i l’atribute “Lang” s’afegeix a aquesta etiqueta.
Aquest valor és ignorat quan Aspose.Words.Saving.PdfSaveOptions.ExportDocumentStructure és .
ExportParagraphGraphicsToArtifact
Obté o estableix un valor que determina si un gràfic de paràgraf ha de ser marcat com un artefacte.
public bool ExportParagraphGraphicsToArtifact { get; set; }Valor de la propietat
Remarks
El valor estàndard és i els gràfics de paràgrafs (sublícules, l’accent de text, etc.) seran marcats com “Span” en la estructura lògica del document.
Quan el valor és el gràfic del paràgraf es marcarà com “Artifact”.
Aquest valor és ignorat quan Aspose.Words.Saving.PdfSaveOptions.ExportDocumentStructure és .
FontEmbeddingMode
Especifica el mode d’empremta de fonts.
public PdfFontEmbeddingMode FontEmbeddingMode { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfFontEmbeddingMode.EmbedAll.
Aquesta configuració només funciona per al text en ANSI (Windows-1252) codificació. si el document conté text no-ANSI llavors les fonts corresponents s’incorporaran independentment d’aquesta configuraci.
La conformitat amb el PDF/A i el PDF/UA requereix que tots els fonts siguin incorporats. Aspose.Words.Saving.PdfFontEmbeddingMode.EmbedTot valor s’utilitzarà automàticament quan s’emmagatzema en PDF/A i PDF/UA.
HeaderFooterBookmarksExportMode
Determina com s’exporten les notes en els capçalers/foters.
public HeaderFooterBookmarksExportMode HeaderFooterBookmarksExportMode { get; set; }Valor de la propietat
HeaderFooterBookmarksExportMode
Remarks
El valor estàndard és Aspose.Words.Saving.HeaderFooterBookmarksExportMode.All.
Aquesta propietat s’utilitza en conjunció amb l’opció Aspose.Words.Saving.PdfSaveOptions.OutlineOptions.
ImageColorSpaceExportMode
Especifica com s’escollirà l’espai de color per a les imatges en el document PDF.
public PdfImageColorSpaceExportMode ImageColorSpaceExportMode { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfImageColorSpaceExportMode.Auto.
Si el valor Aspose.Words.Saving.PdfImageColorSpaceExportMode.SimpleCmyk és especificat, l’opció de la compressió d’imatges és ignorada i s’utilitza per a totes les imatges del document.
Aspose.Words.Saving.PdfImageColorSpaceExportMode.SimpleCmyk valor no es dóna suport quan s’emmagatzema a PDF/A. Wl26.Salvador.pdfimage Colorspaceexport.Auto valor serà utilitzat en el seu lloc.
ImageCompression
Especifica el tipus de compressió que s’utilitza per a totes les imatges del document.
public PdfImageCompression ImageCompression { get; set; }Valor de la propietat
Remarks
Per defecte és Aspose.Words.Saving.PdfImageCompression.Auto.
Utilitzar Aspose.Words.Saving.PdfImageCompression.Jpeg li permet controlar la qualitat de les imatges en el document de sortida a través de la propietat Aspose.Words.Saving.PdfSaveOptions.JpegQuality.
Utilitzar Aspose.Words.Saving.PdfImageCompression.Jpeg proporciona la velocitat de conversió més ràpida en comparació amb el rendiment d’altres tipus de compressió, però en aquest cas, hi ha pèrdua de compressió JPEG.
Utilitzant Aspose.Words.Saving.PdfImageCompression.Auto permet controlar la qualitat de Jpeg en el document de sortida a través de la propietat Aspose.Words.Saving.PdfSaveOptions.JpegQuality, però per a altres formats, les dades de píxels crus s’extreuen i s’emmagatzemen amb la compressió Flate. Aquest cas és més lent que la conversió Jpeg però sense pèrdues.
InterpolateImages
Una bandera que indica si la interpolació d’imatge s’ha de realitzar per un lector de conformitat.Quan s’especifica la ‘falsa’, la bandera no s’escriu al document de sortida i s’utilitza en canvi el comportament estàndard del lector.
public bool InterpolateImages { get; set; }Valor de la propietat
Remarks
Quan la resolució d’una imatge font és significativament inferior a la del dispositiu de sortida, cada mostra font cobreix molts píxels de dispositius. Com a resultat, les imatges poden aparèixer joguines o bloquejades. Aquests artefactes visuals es poden reduir aplicant un algoritme de interpolació de la imatge durant la renderització. En lloc de pintar tots els pixels coberts per un mostre font amb el mateix color, la interacció imatge intenta produir una transició suau entre els valors de mostra adjacents.
Un lector de conformitat pot optar per no implementar aquesta funció de PDF, o pot utilitzar qualsevol implementació específica d’interpolació que desitgi.
El valor defectuós és .
La bandera d’interpolació està prohibida per la conformitat PDF/A. el valor s’utilitzarà automàticament quan s’emmagatzema en PDF/A.
JpegQuality
Obté o estableix un valor que determina la qualitat de les imatges JPEG dins del document PDF.
public int JpegQuality { get; set; }Valor de la propietat
Remarks
El valor estàndard és 100.
Aquesta propietat s’utilitza en conjunció amb l’opció Aspose.Words.Saving.PdfSaveOptions.ImageCompression.
Només funciona quan un document conté imatges JPEG.
Utilitza aquesta propietat per obtenir o configurar la qualitat de les imatges dins d’un document quan s’emmagatzema en format PDF. El valor pot variar de 0 a 100 on 0 significa la pitjor qualitat però la compressió màxima i 100 significa la millor qualitat però la compressió mínima. Si la qualitat és 100 i la imatge font és JPEG, no significa compressió - els bits originals es salvar.
OpenHyperlinksInNewWindow
Obté o estableix un valor que determina si hi ha hiperenllaços en el document PDF de sortidas’han d’obrir en una nova finestra (o taula) d’un navegador.
public bool OpenHyperlinksInNewWindow { get; set; }Valor de la propietat
Remarks
El valor estàndard és . Quan aquest valor s’estableix a les hiperenllaços es salven utilitzant el codi JavaScript.
Tingueu en compte que si aquesta opció s’estableix a les hiperenllaços no pot funcionar en alguns lectors de PDF com Chrome, Firefox.
Les accions de JavaScript estan prohibides per la conformitat PDF/A-1 i PDF/A-2. s’utilitzaran automàticament quan s’emmagatzema a PDF/A-1 i PDF/A-2.
OutlineOptions
Permet especificar les opcions d’outline.
public OutlineOptions OutlineOptions { get; }Valor de la propietat
Remarks
Les sortides es poden crear a partir de títols i etiquetes.
Per als títols, el nivell d’origen es determina pel nivell d’origen.
s possible establir el nivell màxim de titulació per a ser inclòs en les entrades o desactivar les entrades de titulació en tot.
Per a les notes, el nivell d’extensió es pot definir en opcions com a valor predefinit per a totes les notes o com a valors individuals per a determinades notes.
A més, les sortides es poden exportar al format XPS utilitzant la mateixa classe Aspose.Words.Saving.PdfSaveOptions.OutlineOptions.
PageLayout
Especifica el disseny de la pàgina que s’utilitza quan el document s’obre en un lector PDF.
public PdfPageLayout PageLayout { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfPageLayout.SinglePage.
PageMode
Especifica com s’ha de mostrar el document PDF quan s’obri en un lector PDF.
public PdfPageMode PageMode { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfPageMode.UseOutlines.
PreblendImages
Obté o s’estableix un valor que determina si o no per barrejar imatges transparents amb color de fons negre.
public bool PreblendImages { get; set; }Valor de la propietat
Remarks
Les imatges premixades poden millorar l’aparença visual del document PDF a l’Adobe Reader i eliminar els artefactes anti-aliasing.
Per mostrar correctament les imatges premejades, l’aplicació de visualització de PDF ha de donar suport a /Matte entrada en el diccionari d’imatges de màscara suau.
El valor defectuós és .
PreserveFormFields
Especifica si guardar els camps de formulari de Microsoft Word com a camps de formulari en PDF o convertir-los en text.Default és ‘false’.
public bool PreserveFormFields { get; set; }Valor de la propietat
Remarks
Els camps de formulari de Microsoft Word inclouen entrada de text, descàrrega i controls de caixa de verificaci.
Quan s’estableix , aquests camps s’exportaran com a text a PDF. Quan s’estableix , aquests camps s’exportaran com a camps de formularis PDF.
Quan exportar camps de formulari a PDF com a camps de formulari, algunes pèrdues de formatació poden ocórrer perquè els camps de formulari PDF no donen suport a totes les característiques dels camps de formulari de Microsoft Word.
A més, la mida de la sortida depèn de la mida del contingut perquè els formularis editables en Microsoft Word són objectes en línia.
Els formularis editats estan prohibits per la conformitat PDF/A. el valor s’utilitzarà automàticament quan s’emmagatzema en PDF/A.
Els camps de formulari no es donen suport quan s’emmagatzema en PDF/UA. valor s’utilitzarà automàticament.
RenderChoiceFormFieldBorder
Especifica si per fer el format d’elecció de PDF el límit de camp.
public bool RenderChoiceFormFieldBorder { get; set; }Valor de la propietat
Remarks
Els camps de formulari d’elecció PDF s’utilitzen per exportar SDT Combo Box Control de contingut, SDT Drop-Down List Control de contingut i heretat Drop-Down Form Field quan s’activa l’opció Aspose.Words.Saving.PdfSaveOptions.PreserveFormFields.
El valor defectuós és .
SaveFormat
Especifica el format en el qual el document serà guardat si s’utilitza aquest objecte d’opcions d’emmagatzematge.Només pot ser Aspose.Words.SaveFormat.Pdf.
public override SaveFormat SaveFormat { get; set; }Valor de la propietat
TextCompression
Especifica el tipus de compressió que s’utilitza per a tots els continguts textuals del document.
public PdfTextCompression TextCompression { get; set; }Valor de la propietat
Remarks
Per defecte és Aspose.Words.Saving.PdfTextCompression.Flate.
Augmenta significativament la mida de la sortida quan s’emmagatzema un document sense compressi.
UseBookFoldPrintingSettings
Obtenir o establir un valor booleà que indiqui si el document ha de ser guardat utilitzant un disseny d’impressió de llibres,Si s’especifica a través de Aspose.Words.PageSetup.MultiplePages.
public bool UseBookFoldPrintingSettings { get; set; }Valor de la propietat
Remarks
<p>Si aquesta opció és especificada, Aspose.Words.Saving.FixedPageSaveOptions.PageSet és ignorat quan estalvi.Aquest comportament coincideix amb MS Word.Si les configuracions d’impressió del llibre no estan especificades en la configuració de pàgina, aquesta opció no tindrà efecte.
UseCoreFonts
Obtenir o establir un valor que determina si substituir fonts TrueType Arial, Times New Roman,Courier Nou i símbol amb fonts de base PDF tipus 1.
public bool UseCoreFonts { get; set; }Valor de la propietat
Remarks
Quan aquest valor s’estableix a Arial, Times New Roman, Courier New i Symbol fonts es reemplacen en el document PDF amb la font de tipus 1 de base corresponent.
Les fonts de PDF bàsics, o les seves mètriques de fonts i les fonts de substitució adequades, es requereixen per estar disponibles per a qualsevol aplicació de visualització de PDF.
Aquesta configuració només funciona per al text en codificació ANSI (Windows-1252). text no ANSI s’escriurà amb font TrueType incorporat independentment d’aquesta configuraci.
La conformitat PDF/A i PDF/UA requereix que totes les fonts siguin incorporades. valor s’utilitzarà automàticament quan s’emmagatzema en PDF/A i PDF/UA.
Els fonts bàsics no es donen suport quan s’emmagatzema en format PDF 2.0. el valor s’utilitzarà automàticament quan s’emmagatzema en format PDF 2.0.
Aquesta opció té una prioritat més alta llavors Aspose.Words.Saving.PdfSaveOptions.FontEmbeddingMode opci.
UseSdtTagAsFormFieldName
Especifica si utilitzar la propietat de l’etiqueta de control SDT o ID com a nom del camp de formulari en PDF.
public bool UseSdtTagAsFormFieldName { get; set; }Valor de la propietat
Remarks
El valor defectuós és .
Quan s’estableix , la propietat de ID de control SDT s’utilitza com un nom del camp de formulari en PDF.
Quan s’estableix , la propietat de tag de control SDT s’utilitza com un nom del camp de formulari en PDF.
Si s’estableix i la etiqueta és buida, la propietat ID s’utilitzarà com un nom de camp de formulari.
Si els valors d’etiquetes i etiquetes no són únics, els valors de etiquetes duplicats es canviaran per crear noms de camps de formulari PDF únics.
ZoomBehavior
Obté o estableix un valor que determina quin tipus de zoom s’ha d’aplicar quan s’obre un document amb un visualitzador PDF.
public PdfZoomBehavior ZoomBehavior { get; set; }Valor de la propietat
Remarks
El valor estàndard és Aspose.Words.Saving.PdfZoomBehavior.None, és a dir, no s’aplica cap fit.
ZoomFactor
Obté o estableix un valor que determina el factor de zoom (en percentatges) per a un document.
public int ZoomFactor { get; set; }Valor de la propietat
Remarks
Aquest valor només s’utilitza si Aspose.Words.Saving.PdfSaveOptions.ZoomBehavior està configurat a Aspose.Words.Saving.PdfZoomBehavior.ZoomFactor.
Methods
Clone()
Crea una clona profunda d’aquest objecte.
public PdfSaveOptions Clone()