PdfSaveOptions

PdfSaveOptions class

Può essere utilizzato per specificare opzioni aggiuntive quando si salva un documento nel filePdf formato.

Per saperne di più, visita ilSpecificare le opzioni di salvataggio articolo di documentazione.

public class PdfSaveOptions : FixedPageSaveOptions

Costruttori

NomeDescrizione
PdfSaveOptions()Inizializza una nuova istanza di questa classe che può essere utilizzata per salvare un documento in Pdf formato.

Proprietà

NomeDescrizione
AdditionalTextPositioning { get; set; }Un flag che specifica se scrivere o meno operatori di posizionamento del testo aggiuntivi.
AllowEmbeddingPostScriptFonts { get; set; }Ottiene o imposta un valore booleano che indica se consentire l’incorporamento di caratteri con contorni PostScript quando si incorporano caratteri TrueType in un documento al momento del salvataggio. Il valore predefinito èfalso .
CacheBackgroundGraphics { get; set; }Ottiene o imposta un valore che determina se memorizzare o meno nella cache la grafica posizionata sullo sfondo del documento.
ColorMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering dei colori.
Compliance { get; set; }Specifica il livello di conformità agli standard PDF per i documenti di output.
CreateNoteHyperlinks { get; set; }Specifica se convertire i riferimenti alle note a piè di pagina/note di chiusura nel brano del testo principale in collegamenti ipertestuali attivi. Quando si fa clic, il collegamento ipertestuale porterà alla nota a piè di pagina/nota di chiusura corrispondente. L’impostazione predefinita èfalso .
CustomPropertiesExport { get; set; }Ottiene o imposta un valore che determina il modoCustomDocumentProperties vengono esportati in un file PDF.
CustomTimeZoneInfo { get; set; }Ottiene o imposta il fuso orario locale personalizzato utilizzato per i campi data/ora.
DefaultTemplate { get; set; }Ottiene o imposta il percorso del modello predefinito (incluso il nome file). Il valore predefinito per questa proprietà èstringa vuota (Empty).
DigitalSignatureDetails { get; set; }Ottiene o imposta i dettagli per la firma del documento PDF di output.
DisplayDocTitle { get; set; }Un flag che specifica se la barra del titolo della finestra deve visualizzare il titolo del documento preso da la voce Titolo del dizionario delle informazioni del documento.
Dml3DEffectsRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering degli effetti 3D.
override DmlEffectsRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering degli effetti DrawingML.
DmlRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering delle forme DrawingML.
DownsampleOptions { get; set; }Permette di specificare le opzioni di downsample.
EmbedAttachments { get; set; }Ottiene o imposta un valore che determina se incorporare o meno gli allegati nel documento PDF.
EmbedFullFonts { get; set; }Controlla il modo in cui i caratteri vengono incorporati nei documenti PDF risultanti.
EncryptionDetails { get; set; }Ottiene o imposta i dettagli per crittografare il documento PDF di output.
ExportDocumentStructure { get; set; }Ottiene o imposta un valore che determina se esportare o meno la struttura del documento.
ExportGeneratorName { get; set; }QuandoVERO , fa sì che il nome e la versione di Aspose.Words vengano incorporati nei file prodotti. Il valore predefinito èVERO .
ExportLanguageToSpanTag { get; set; }Ottiene o imposta un valore che determina se creare o meno un tag “Span” nella struttura del documento per esportare la lingua del testo.
ExportParagraphGraphicsToArtifact { get; set; }Ottiene o imposta un valore che determina se un elemento grafico di paragrafo deve essere contrassegnato come artefatto.
FontEmbeddingMode { get; set; }Specifica la modalità di incorporamento dei caratteri.
HeaderFooterBookmarksExportMode { get; set; }Determina la modalità di esportazione dei segnalibri nelle intestazioni/piè di pagina.
ImageColorSpaceExportMode { get; set; }Specifica come verrà selezionato lo spazio colore per le immagini nel documento PDF.
ImageCompression { get; set; }Specifica il tipo di compressione da utilizzare per tutte le immagini nel documento.
ImlRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering degli oggetti input penna (InkML).
InterpolateImages { get; set; }Un flag che indica se l’interpolazione dell’immagine deve essere eseguita da un lettore conforme. Quandofalso è specificato, il flag non viene scritto nel documento di output e al suo posto viene utilizzato il comportamento predefinito del lettore.
JpegQuality { get; set; }Ottiene o imposta un valore che determina la qualità delle immagini JPEG all’interno del documento PDF.
MemoryOptimization { get; set; }Ottiene o imposta un valore che determina se l’ottimizzazione della memoria deve essere eseguita prima di salvare il documento. Il valore predefinito per questa proprietà èfalso .
MetafileRenderingOptions { get; set; }Permette di specificare le opzioni di rendering del metafile.
NumeralFormat { get; set; }Ottiene o impostaNumeralFormat utilizzato per il rendering dei numeri. I numeri europei vengono utilizzati per impostazione predefinita.
OpenHyperlinksInNewWindow { get; set; }Ottiene o imposta un valore che determina se i collegamenti ipertestuali nel documento Pdf di output devono essere aperti in una nuova finestra (o scheda) di un browser.
virtual OptimizeOutput { get; set; }Il flag indica se è necessario ottimizzare l’output. Se questo flag è impostato, le tele nidificate ridondanti e le tele vuote vengono rimosse, vengono concatenati anche i glifi vicini con la stessa formattazione. Nota: la precisione della visualizzazione del contenuto potrebbe essere influenzata se questa proprietà è impostata suVERO . L’impostazione predefinita èfalso .
OutlineOptions { get; }Permette di specificare le opzioni del contorno.
PageMode { get; set; }Specifica come deve essere visualizzato il documento PDF quando viene aperto nel lettore PDF.
PageSavingCallback { get; set; }Permette di controllare come vengono salvate le pagine separate quando un documento viene esportato in un formato di pagina fisso.
PageSet { get; set; }Ottiene o imposta le pagine da visualizzare. L’impostazione predefinita è tutte le pagine nel documento.
PreblendImages { get; set; }Ottiene o imposta un valore che determina se prefondere o meno le immagini trasparenti con il colore di sfondo nero.
PreserveFormFields { get; set; }Specifica se conservare i campi modulo di Microsoft Word come campi modulo in PDF o convertirli in testo. L’impostazione predefinita èfalso .
PrettyFormat { get; set; }QuandoVERO formati di output graziosi dove applicabile. Il valore predefinito èfalso .
ProgressCallback { get; set; }Chiamato durante il salvataggio di un documento e accetta i dati sull’avanzamento del salvataggio.
override SaveFormat { get; set; }Specifica il formato in cui il documento verrà salvato se viene utilizzato questo oggetto opzioni di salvataggio. Può esserePdf .
TempFolder { get; set; }Specifica la cartella per i file temporanei utilizzata durante il salvataggio in un file DOC o DOCX. Per impostazione predefinita questa proprietà ènullo e non vengono utilizzati file temporanei.
TextCompression { get; set; }Specifica il tipo di compressione da utilizzare per tutto il contenuto testuale nel documento.
UpdateCreatedTimeProperty { get; set; }Ottiene o imposta un valore che determina se ilCreatedTime la proprietà viene aggiornata prima del salvataggio. Il valore predefinito èfalso ;
UpdateFields { get; set; }Ottiene o imposta un valore che determina se i campi di determinati tipi devono essere aggiornati prima di salvare il documento in un formato di pagina fisso. Il valore predefinito per questa proprietà èVERO .
UpdateLastPrintedProperty { get; set; }Ottiene o imposta un valore che determina se ilLastPrinted la proprietà viene aggiornata prima del salvataggio.
UpdateLastSavedTimeProperty { get; set; }Ottiene o imposta un valore che determina se ilLastSavedTime la proprietà viene aggiornata prima del salvataggio.
UseAntiAliasing { get; set; }Ottiene o imposta un valore che determina se utilizzare o meno l’antialiasing per il rendering.
UseBookFoldPrintingSettings { get; set; }Ottiene o imposta un valore booleano che indica se il documento deve essere salvato utilizzando un layout di stampa booklet, se specificato tramiteMultiplePages .
UseCoreFonts { get; set; }Ottiene o imposta un valore che determina se sostituire o meno i caratteri TrueType Arial, Times New Roman, Courier New e Symbol con i caratteri PDF Type 1 principali.
UseHighQualityRendering { get; set; }Ottiene o imposta un valore che determina se utilizzare o meno algoritmi di rendering di alta qualità (ovvero lenti).
ZoomBehavior { get; set; }Ottiene o imposta un valore che determina il tipo di zoom da applicare quando un documento viene aperto con un visualizzatore PDF.
ZoomFactor { get; set; }Ottiene o imposta un valore che determina il fattore di zoom (in percentuale) per un documento.

Metodi

NomeDescrizione
Clone()Crea un clone profondo di questo oggetto.
override Equals(object)Determina se l’oggetto specificato ha un valore uguale all’oggetto corrente.

Esempi

Mostra come modificare il colore dell’immagine con la proprietà delle opzioni di salvataggio.

Document doc = new Document(MyDir + "Images.docx");

// Crea un oggetto "PdfSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui il metodo converte il documento in .PDF.
// Imposta la proprietà "ColorMode" su "Grayscale" per visualizzare tutte le immagini del documento in bianco e nero.
// La dimensione del documento di output potrebbe essere maggiore con questa impostazione.
// Imposta la proprietà "ColorMode" su "Normale" per visualizzare tutte le immagini a colori.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };

doc.Save(ArtifactsDir + "PdfSaveOptions.ColorRendering.pdf", pdfSaveOptions);

Mostra come applicare la compressione del testo quando si salva un documento in 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.");

// Crea un oggetto "PdfSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui il metodo converte il documento in .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Imposta la proprietà "TextCompression" su "PdfTextCompression.None" per non applicarne alcuna
// compressione in testo quando salviamo il documento in PDF.
// Imposta la proprietà "TextCompression" su "PdfTextCompression.Flate" per applicare la compressione ZIP
// in testo quando salviamo il documento in PDF. Più grande è il documento, maggiore sarà l’impatto che ciò avrà.
options.TextCompression = pdfTextCompression;

doc.Save(ArtifactsDir + "PdfSaveOptions.TextCompression.pdf", options);

Mostra come convertire un intero documento in PDF con tre livelli nella struttura del documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserisce le intestazioni dei livelli da 1 a 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");

// Crea un oggetto "PdfSaveOptions" che possiamo passare al metodo "Save" del documento
// per modificare il modo in cui il metodo converte il documento in .PDF.
PdfSaveOptions options = new PdfSaveOptions();

// Il documento PDF di output conterrà una struttura, ovvero un sommario che elenca le intestazioni nel corpo del documento.
// Facendo clic su una voce in questo schema ci porterà alla posizione della rispettiva intestazione.
// Imposta la proprietà "HeadingsOutlineLevels" su "4" per escludere dalla struttura tutte le intestazioni i cui livelli sono superiori a 4.
options.OutlineOptions.HeadingsOutlineLevels = 4;

// Se una voce di struttura ha voci successive di livello superiore tra sé e la voce successiva dello stesso livello o di livello inferiore,
// apparirà una freccia a sinistra della voce. Questa voce è il "proprietario" di diverse "sottovoci" di questo tipo.
// Nel nostro documento, le voci di struttura del 5° livello di intestazione sono sottovoci della seconda voce di struttura di 4° livello,
// le voci di 4° e 5° livello di intestazione sono sottovoci della seconda voce di 3° livello e così via.
// Nella struttura, possiamo fare clic sulla freccia della voce "proprietario" per comprimere/espandere tutte le sue sottovoci.
// Imposta la proprietà "ExpandedOutlineLevels" su "2" per espandere automaticamente tutte le voci di intestazione di livello 2 e di struttura inferiore
// e comprime tutte le voci di livello 3 e superiori quando apriamo il documento.
options.OutlineOptions.ExpandedOutlineLevels = 2;

doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);

Guarda anche