PdfSaveOptions

PdfSaveOptions class

Kann zum Angeben zusätzlicher Optionen beim Speichern eines Dokuments im verwendet werdenPdf format.

Um mehr zu erfahren, besuchen Sie dieGeben Sie Speicheroptionen an Dokumentationsartikel.

public class PdfSaveOptions : FixedPageSaveOptions

Konstrukteure

NameBeschreibung
PdfSaveOptions()Initialisiert eine neue Instanz dieser Klasse, die zum Speichern eines Dokuments im verwendet werden kann.Pdf format.

Eigenschaften

NameBeschreibung
AdditionalTextPositioning { get; set; }Ein Flag, das angibt, ob zusätzliche Textpositionierungsoperatoren geschrieben werden sollen oder nicht.
AllowEmbeddingPostScriptFonts { get; set; }Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob das Einbetten von Schriftarten mit PostScript-Umrissen zulässig ist , wenn TrueType-Schriftarten in ein Dokument eingebettet werden, sobald es gespeichert wird. Der Standardwert istFALSCH .
CacheBackgroundGraphics { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob im Hintergrund des Dokuments platzierte Grafiken zwischengespeichert werden sollen oder nicht.
ColorMode { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie Farben gerendert werden.
Compliance { get; set; }Gibt den Konformitätsgrad der PDF-Standards für Ausgabedokumente an.
CreateNoteHyperlinks { get; set; }Gibt an, ob Fußnoten-/Endnotenverweise im Haupttext in aktive Hyperlinks umgewandelt werden. Beim Klicken führt der Hyperlink zur entsprechenden Fußnote/Endnote. Die Standardeinstellung istFALSCH .
CustomPropertiesExport { get; set; }Ruft einen Wert ab, der den Weg bestimmt, oder legt diesen festCustomDocumentProperties werden in eine PDF-Datei exportiert.
CustomTimeZoneInfo { get; set; }Ruft die benutzerdefinierte lokale Zeitzone ab, die für Datums-/Uhrzeitfelder verwendet wird, oder legt diese fest.
DefaultTemplate { get; set; }Ruft den Pfad zur Standardvorlage (einschließlich Dateiname) ab oder legt diesen fest. Der Standardwert für diese Eigenschaft istleerer String (Empty).
DigitalSignatureDetails { get; set; }Ruft die Details zum Signieren des ausgegebenen PDF-Dokuments ab oder legt diese fest.
DisplayDocTitle { get; set; }Ein Flag, das angibt, ob in der Titelleiste des Fensters der Dokumenttitel angezeigt werden soll, der aus dem Titeleintrag des Dokumentinformationswörterbuchs stammt.
Dml3DEffectsRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie 3D-Effekte gerendert werden.
override DmlEffectsRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie DrawingML-Effekte gerendert werden.
DmlRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie DrawingML-Formen gerendert werden.
DownsampleOptions { get; set; }Ermöglicht die Angabe von Downsampling-Optionen.
EmbedAttachments { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Anhänge in das PDF-Dokument eingebettet werden sollen oder nicht.
EmbedFullFonts { get; set; }Steuert, wie Schriftarten in die resultierenden PDF-Dokumente eingebettet werden.
EncryptionDetails { get; set; }Ruft die Details zum Verschlüsseln des ausgegebenen PDF-Dokuments ab oder legt diese fest.
ExportDocumentStructure { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob die Dokumentstruktur exportiert werden soll oder nicht.
ExportGeneratorName { get; set; }WannWAHR , bewirkt, dass der Name und die Version von Aspose.Words in erzeugte Dateien eingebettet werden. Der Standardwert istWAHR .
ExportLanguageToSpanTag { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob ein „Span“-Tag in der Dokumentstruktur erstellt werden soll, um die Textsprache zu exportieren.
ExportParagraphGraphicsToArtifact { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob eine Absatzgrafik als Artefakt markiert werden soll.
FontEmbeddingMode { get; set; }Gibt den Schriftarteinbettungsmodus an.
HeaderFooterBookmarksExportMode { get; set; }Legt fest, wie Lesezeichen in Kopf-/Fußzeilen exportiert werden.
ImageColorSpaceExportMode { get; set; }Gibt an, wie der Farbraum für die Bilder im PDF-Dokument ausgewählt wird.
ImageCompression { get; set; }Gibt den Komprimierungstyp an, der für alle Bilder im Dokument verwendet werden soll.
ImlRenderingMode { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, wie Ink-Objekte (InkML) gerendert werden.
InterpolateImages { get; set; }Ein Flag, das angibt, ob die Bildinterpolation von einem konformen Lesegerät durchgeführt werden soll. WannFALSCH angegeben ist, wird das Flag nicht in das Ausgabedokument geschrieben und stattdessen wird das Standardverhalten des Readers verwendet.
JpegQuality { get; set; }Ruft einen Wert ab oder legt diesen fest, der die Qualität der JPEG-Bilder im PDF-Dokument bestimmt.
MemoryOptimization { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob vor dem Speichern des Dokuments eine Speicheroptimierung durchgeführt werden soll. Der Standardwert für diese Eigenschaft istFALSCH .
MetafileRenderingOptions { get; set; }Ermöglicht die Angabe von Metadatei-Rendering-Optionen.
NumeralFormat { get; set; }Ruft ab oder legt festNumeralFormat Wird zur Darstellung von Ziffern verwendet. Standardmäßig werden europäische Ziffern verwendet.
OpenHyperlinksInNewWindow { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Hyperlinks im Ausgabe-PDF-Dokument gezwungen werden, in einem neuen Fenster (oder Tab) eines Browsers geöffnet zu werden.
virtual OptimizeOutput { get; set; }Flag gibt an, ob es zur Optimierung der Ausgabe erforderlich ist. Wenn dieses Flag gesetzt ist, werden redundante verschachtelte Leinwände und leere Leinwände entfernt, auch benachbarte Glyphen mit derselben Formatierung werden verkettet. Hinweis: Die Genauigkeit der Inhaltsanzeige kann beeinträchtigt werden, wenn Diese Eigenschaft ist auf festgelegtWAHR . Standard istFALSCH .
OutlineOptions { get; }Ermöglicht die Angabe von Umrissoptionen.
PageMode { get; set; }Gibt an, wie das PDF-Dokument beim Öffnen im PDF-Reader angezeigt werden soll.
PageSavingCallback { get; set; }Ermöglicht die Steuerung, wie einzelne Seiten gespeichert werden, wenn ein Dokument in ein festes Seitenformat exportiert wird.
PageSet { get; set; }Ruft die zu rendernden Seiten ab oder legt diese fest. Standard sind alle Seiten im Dokument.
PreblendImages { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob transparente Bilder mit schwarzer Hintergrundfarbe vorgemischt werden sollen oder nicht.
PreserveFormFields { get; set; }Gibt an, ob Microsoft Word-Formularfelder als Formularfelder in PDF beibehalten oder in Text konvertiert werden sollen. Die Standardeinstellung istFALSCH .
PrettyFormat { get; set; }WannWAHR hübsche Ausgabeformate, sofern zutreffend. Der Standardwert istFALSCH .
ProgressCallback { get; set; }Wird beim Speichern eines Dokuments aufgerufen und akzeptiert Daten über den Speicherfortschritt.
override SaveFormat { get; set; }Gibt das Format an, in dem das Dokument gespeichert wird, wenn dieses Speicheroptionsobjekt verwendet wird. Kann nur seinPdf .
TempFolder { get; set; }Gibt den Ordner für temporäre Dateien an, die beim Speichern in einer DOC- oder DOCX-Datei verwendet werden. Standardmäßig ist diese EigenschaftNull und es werden keine temporären Dateien verwendet.
TextCompression { get; set; }Gibt den Komprimierungstyp an, der für den gesamten Textinhalt im Dokument verwendet werden soll.
UpdateCreatedTimeProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieCreatedTime Die Eigenschaft wird vor dem Speichern aktualisiert. Der Standardwert istFALSCH ;
UpdateFields { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Felder bestimmter Typen aktualisiert werden sollen, bevor das Dokument in einem festen Seitenformat gespeichert wird. Der Standardwert für diese Eigenschaft istWAHR .
UpdateLastPrintedProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieLastPrinted Eigenschaft wird vor dem Speichern aktualisiert.
UpdateLastSavedTimeProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieLastSavedTime Eigenschaft wird vor dem Speichern aktualisiert.
UseAntiAliasing { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob Anti-Aliasing für das Rendering verwendet werden soll oder nicht.
UseBookFoldPrintingSettings { get; set; }Ruft einen booleschen Wert ab oder legt diesen fest, der angibt, ob das Dokument mit einem Broschürendrucklayout gespeichert werden soll, , wenn es über angegeben wirdMultiplePages .
UseCoreFonts { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob die TrueType-Schriftarten Arial, Times New Roman, Courier New und Symbol durch Kernschriftarten des PDF-Typs 1 ersetzt werden sollen.
UseHighQualityRendering { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, ob hochwertige (d. h. langsame) Rendering-Algorithmen verwendet werden sollen oder nicht.
ZoomBehavior { get; set; }Ruft einen Wert ab oder legt diesen fest, der bestimmt, welcher Zoomtyp angewendet werden soll, wenn ein Dokument mit einem PDF-Viewer geöffnet wird.
ZoomFactor { get; set; }Ruft einen Wert ab, der den Zoomfaktor (in Prozent) für ein Dokument bestimmt, oder legt diesen fest.

Methoden

NameBeschreibung
Clone()Erstellt einen tiefen Klon dieses Objekts.
override Equals(object)Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat.

Beispiele

Zeigt, wie man die Bildfarbe mit der Eigenschaft „Speicheroptionen“ ändert.

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

// Erstellen Sie ein „PdfSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um zu ändern, wie diese Methode das Dokument in .PDF konvertiert.
// Setzen Sie die Eigenschaft „ColorMode“ auf „Grayscale“, um alle Bilder aus dem Dokument in Schwarzweiß darzustellen.
// Die Größe des Ausgabedokuments kann bei dieser Einstellung größer sein.
// Setzen Sie die Eigenschaft „ColorMode“ auf „Normal“, um alle Bilder in Farbe darzustellen.
PdfSaveOptions pdfSaveOptions = new PdfSaveOptions { ColorMode = colorMode };

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

Zeigt, wie Sie beim Speichern eines Dokuments als PDF eine Textkomprimierung anwenden.

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.");

// Erstellen Sie ein „PdfSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um zu ändern, wie diese Methode das Dokument in .PDF konvertiert.
PdfSaveOptions options = new PdfSaveOptions();

// Setzen Sie die Eigenschaft „TextCompression“ auf „PdfTextCompression.None“, um keine anzuwenden
// Komprimierung in Text, wenn wir das Dokument als PDF speichern.
// Setzen Sie die Eigenschaft „TextCompression“ auf „PdfTextCompression.Flate“, um die ZIP-Komprimierung anzuwenden
// in Text, wenn wir das Dokument als PDF speichern. Je größer das Dokument ist, desto größer sind die Auswirkungen.
options.TextCompression = pdfTextCompression;

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

Zeigt, wie ein gesamtes Dokument mit drei Ebenen in der Dokumentgliederung in PDF konvertiert wird.

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

// Überschriften der Ebenen 1 bis 5 einfügen.
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");

// Erstellen Sie ein „PdfSaveOptions“-Objekt, das wir an die „Save“-Methode des Dokuments übergeben können
// um zu ändern, wie diese Methode das Dokument in .PDF konvertiert.
PdfSaveOptions options = new PdfSaveOptions();

// Das ausgegebene PDF-Dokument enthält eine Gliederung, bei der es sich um ein Inhaltsverzeichnis handelt, das die Überschriften im Hauptteil des Dokuments auflistet.
// Durch Klicken auf einen Eintrag in dieser Gliederung gelangen wir zur Position der entsprechenden Überschrift.
// Setzen Sie die Eigenschaft „HeadingsOutlineLevels“ auf „4“, um alle Überschriften, deren Ebenen über 4 liegen, aus der Gliederung auszuschließen.
options.OutlineOptions.HeadingsOutlineLevels = 4;

// Wenn ein Gliederungseintrag zwischen sich und dem nächsten Eintrag derselben oder einer niedrigeren Ebene nachfolgende Einträge einer höheren Ebene hat,
// links neben dem Eintrag erscheint ein Pfeil. Dieser Eintrag ist „Eigentümer“ mehrerer solcher „Untereinträge“.
// In unserem Dokument sind die Gliederungseinträge der 5. Überschriftenebene Untereinträge des zweiten Gliederungseintrags der 4. Ebene,
// Die Einträge der 4. und 5. Überschriftenebene sind Untereinträge des zweiten Eintrags der 3. Ebene usw.
// In der Gliederung können wir auf den Pfeil des Eintrags „Eigentümer“ klicken, um alle Untereinträge ein-/auszuklappen.
// Setzen Sie die Eigenschaft „ExpandedOutlineLevels“ auf „2“, um alle Gliederungseinträge der Überschriftenebene 2 und darunter automatisch zu erweitern
// und alle Einträge der Ebene und 3 und höher ausblenden, wenn wir das Dokument öffnen.
options.OutlineOptions.ExpandedOutlineLevels = 2;

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

Siehe auch

PdfPermissions Enum PdfTextCompression Enum