PdfSaveOptions

PdfSaveOptions class

Kann verwendet werden, um zusätzliche Optionen beim Speichern eines Dokuments imPdf format.

Um mehr zu erfahren, besuchen Sie dieSpeicheroptionen festlegen 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 ihn fest, der angibt, ob das Einbetten von Schriftarten mit PostScript-Konturen beim Einbetten von TrueType-Schriftarten in ein Dokument beim Speichern zulässig ist. Der Standardwert istFALSCH .
AttachmentsEmbeddingMode { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie Anhänge in das PDF-Dokument eingebettet werden.
CacheBackgroundGraphics { get; set; }Ruft einen Wert ab oder legt einen Wert 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 mit PDF-Standards für Ausgabedokumente an.
CreateNoteHyperlinks { get; set; }Gibt an, ob Fußnoten-/Endnotenverweise im Haupttext in aktive Hyperlinks umgewandelt werden sollen. Beim Anklicken führt der Hyperlink zur entsprechenden Fußnote/Endnote. Standard istFALSCH .
CustomPropertiesExport { get; set; }Ruft einen Wert ab oder legt ihn fest, der die Art und Weise bestimmt,CustomDocumentProperties 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 ab oder legt ihn fest (einschließlich Dateiname). Der Standardwert für diese Eigenschaft istleere Zeichenfolge (Empty ).
DigitalSignatureDetails { get; set; }Ruft die Details zum Signieren des PDF-Ausgabedokuments ab oder legt sie fest.
DisplayDocTitle { get; set; }Ein Flag, das angibt, ob in der Titelleiste des Fensters der Dokumenttitel angezeigt werden soll, der dem Titeleintrag des Dokumentinformationswörterbuchs entnommen wurde.
Dml3DEffectsRenderingMode { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, wie 3D-Effekte gerendert werden.
override DmlEffectsRenderingMode { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie DrawingML-Effekte gerendert werden.
DmlRenderingMode { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie DrawingML-Formen gerendert werden.
DownsampleOptions { get; set; }Ermöglicht die Angabe von Downsampling-Optionen.
EmbedFullFonts { get; set; }Steuert, wie Schriftarten in die resultierenden PDF-Dokumente eingebettet werden.
EncryptionDetails { get; set; }Ruft die Details zum Verschlüsseln des PDF-Ausgabedokuments ab oder legt sie fest.
ExportDocumentStructure { get; set; }Ruft einen Wert ab oder legt ihn 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 die erstellten Dateien eingebettet werden. Der Standardwert istWAHR .
ExportLanguageToSpanTag { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob zum Exportieren der Textsprache ein „Span“-Tag in der Dokumentstruktur erstellt werden soll oder nicht.
ExportParagraphGraphicsToArtifact { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob eine Absatzgrafik als Artefakt markiert werden soll.
FontEmbeddingMode { get; set; }Gibt den Schriftarteinbettungsmodus an.
HeaderFooterBookmarksExportMode { get; set; }Bestimmt, 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 einen Wert fest, der bestimmt, wie InkML-Objekte gerendert werden.
InterpolateImages { get; set; }Ein Flag, das angibt, ob die Bildinterpolation von einem konformen Reader durchgeführt werden soll. WennFALSCH 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 ihn fest, der die Qualität der JPEG-Bilder im PDF-Dokument bestimmt.
MemoryOptimization { get; set; }Ruft einen Wert ab oder legt ihn 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 Optionen für das Rendern von Metadateien.
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 einen Wert fest, der bestimmt, ob Hyperlinks im PDF-Ausgabedokument in einem neuen Fenster (oder Tab) eines Browsers geöffnet werden müssen.
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 der gleichen Formatierung werden verkettet. Hinweis: Die Genauigkeit der Inhaltsanzeige kann beeinträchtigt werden, wenn diese Eigenschaft aufWAHR . Standard istFALSCH .
OutlineOptions { get; }Ermöglicht die Angabe von Gliederungsoptionen.
PageLayout { get; set; }Gibt das Seitenlayout an, das verwendet werden soll, wenn das Dokument in einem PDF-Reader geöffnet wird.
PageMode { get; set; }Gibt an, wie das PDF-Dokument angezeigt werden soll, wenn es in einem PDF-Reader geöffnet wird.
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 sie fest. Standardmäßig sind alle Seiten im Dokument dargestellt.
PreblendImages { get; set; }Ruft einen Wert ab oder legt ihn 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 erhalten bleiben oder in Text konvertiert werden sollen. Der Standardwert istFALSCH .
PrettyFormat { get; set; }WannWAHR , formatiert die Ausgabe, wo anwendbar. Der Standardwert istFALSCH .
ProgressCallback { get; set; }Wird beim Speichern eines Dokuments aufgerufen und akzeptiert Daten zum Speicherfortschritt.
RenderChoiceFormFieldBorder { get; set; }Gibt an, ob der Feldrand des PDF-Auswahlformulars gerendert werden soll.
override SaveFormat { get; set; }Gibt das Format an, in dem das Dokument gespeichert wird, wenn dieses Speicheroptionsobjekt verwendet wird. Kann nurPdf .
TempFolder { get; set; }Gibt den Ordner für temporäre Dateien an, der beim Speichern in eine DOC- oder DOCX-Datei verwendet wird. 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.
UpdateAmbiguousTextFont { get; set; }Bestimmt, ob die Schriftattribute entsprechend dem verwendeten Zeichencode geändert werden.
UpdateCreatedTimeProperty { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob dieCreatedTime Eigenschaft wird vor dem Speichern aktualisiert. Der Standardwert istFALSCH ;
UpdateFields { get; set; }Ruft einen Wert ab oder legt einen Wert 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 einen Wert fest, der bestimmt, ob Anti-Aliasing zum Rendern verwendet werden soll oder nicht.
UseBookFoldPrintingSettings { get; set; }Ruft einen booleschen Wert ab oder legt ihn fest, der angibt, ob das Dokument im Broschüren-Drucklayout gespeichert werden soll, wenn dies überMultiplePages .
UseCoreFonts { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob die TrueType-Schriftarten Arial, Times New Roman, Courier New und Symbol durch PDF Type 1-Kernschriftarten ersetzt werden sollen oder nicht.
UseHighQualityRendering { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob qualitativ hochwertige (d. h. langsame) Rendering-Algorithmen verwendet werden sollen oder nicht.
UseSdtTagAsFormFieldName { get; set; }Gibt an, ob das SDT-Steuerelement-Tag oder die ID-Eigenschaft als Name des Formularfelds in PDF verwendet werden soll.
ZoomBehavior { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, welche Art von Zoom angewendet werden soll, wenn ein Dokument mit einem PDF-Viewer geöffnet wird.
ZoomFactor { get; set; }Ruft einen Wert ab oder legt ihn fest, der den Zoomfaktor (in Prozent) für ein Dokument bestimmt.

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 die Bildfarbe mit der Eigenschaft „Speicheroptionen“ geändert wird.

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 „Graustufen“, um alle Bilder aus dem Dokument in Schwarzweiß darzustellen.
// Die Größe des Ausgabedokuments kann mit 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 beim Speichern eines Dokuments im PDF-Format eine Textkomprimierung angewendet wird.

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
// Komprimierung auf 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, desto größer sind die Auswirkungen.
options.TextCompression = pdfTextCompression;

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

Zeigt, wie ein ganzes 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, d. h. ein Inhaltsverzeichnis, das die Überschriften im Dokumenttext 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 nachfolgende Einträge einer höheren Ebene zwischen sich selbst und dem nächsten Eintrag der gleichen oder niedrigeren Ebene hat,
// links neben dem Eintrag erscheint ein Pfeil. Dieser Eintrag ist der „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 und so weiter.
// In der Gliederung können wir auf den Pfeil des Eintrags „Eigentümer“ klicken, um alle Untereinträge auszublenden/einzuklappen.
// Setzen Sie die Eigenschaft „ExpandedOutlineLevels“ auf „2“, um alle Gliederungseinträge der Überschriftenebene 2 und darunter automatisch zu erweitern
// und reduzieren Sie alle Einträge der Ebene 3 und höher, wenn wir das Dokument öffnen.
options.OutlineOptions.ExpandedOutlineLevels = 2;

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

Siehe auch

PdfPermissions Enum PdfTextCompression Enum