SaveAs - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Speichert eine Kopie des PDF-Dokuments in den angegebenen Stream oder die angegebene Datei mit expliziter PDF 1.3 bis PDF 1.7-Normalisierung und Konformitätsprüfungen

Syntax

function SaveAs(Stream: TStream; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

Stream	TStream-Wert, der die PDF-Daten empfängt
Option	TSaveOption. Speicheroption: `saNone` für eine normale Speicherung, `saIncremental` für ein inkrementelles Update, `saNoIncremental`, um eine vollständige Neuschreibung zu erzwingen, oder `saRemoveSecurity`, um beim Speichern die Sicherheit zu entfernen
PdfVersion	TPdfVersion-Ziel; verwenden Sie `pvUnknown`, um die aktuelle Version beizubehalten

function SaveAs(const FileName: string; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

FileName	string. Der Ausgabedateipfad. Eine temporäre Datei im selben Verzeichnis wird zuerst fertiggestellt und ersetzt dann atomar das Ziel
Option	TSaveOption. Speicheroption: `saNone`, `saIncremental`, `saNoIncremental` oder `saRemoveSecurity`
PdfVersion	TPdfVersion-Ziel; verwenden Sie `pvUnknown`, um die aktuelle Version beizubehalten

Rückgabewert

Liefert True, wenn das Dokument erfolgreich gespeichert wurde, andernfalls False

Beschreibung

Speichert das aktuelle Dokument in einen Dateipfad oder einen TStream

Der Parameter PdfVersion legt die PDF-Ausgabeversion fest; übergeben Sie pvUnknown, um die vorhandene Version des Dokuments beizubehalten

Die Eigenschaft Compressed steuert die Stream-Komprimierung. Hybrid-Reference-, Xref-Stream- und Object-Stream-Eingaben werden bewahrt, wenn eine Klassik-Xref-Neuschreibung deren vollständige Querverweis-Semantik nicht erhalten kann

Jedes vollständige (nicht inkrementelle) Speichern repariert ToUnicode-CMaps von Subset-Fonts, deren Array-Bereichseinträge ihren Zeichenzuordnungen widersprechen, sodass ein neu geladenes Dokument die ursprünglichen Leerzeichen und Bindestriche extrahiert statt U+00A0 und U+00AD; inkrementelle Revisionen, Sparse-Updates und Xref-Stream-Dokumente laufen unverändert durch

Explizite PDF-Versionsprüfungen folgen der aktiven Xref-Revisionskette und den aktiven Object-Stream-Membern, sodass veraltete oder nicht referenzierte Objektkörper die angeforderte Versionsschranke nicht beeinflussen

Die Datei-Überladung lässt ein vorhandenes Ziel unverändert, wenn Komprimierung, Nachbearbeitung oder Versionsvalidierung fehlschlägt

Das Windows-V8-Update aus v3.125.2 repariert die exakte Feldwert-Persistenz für die getesteten Packet-Arrays und den unterstützten Single-Stream-XDP-Teilbereich; ältere Laufzeiten können Single-Stream-Änderungen verwerfen oder zusätzliche Newlines einfügen

Öffnen Sie die XFA-Ausgabe erneut und vergleichen Sie die erforderlichen Feldwerte exakt, bevor Sie sie akzeptieren; schneiden Sie Whitespace nicht ab, um einen Persistenzunterschied zu verschleiern

Konformitätsverhalten

pv13 normalisiert geerbte Seitenressourcen, vereinheitlicht /ProcSet und entfernt nur initiale Transparenz-Zustandswerte einschließlich /BM /Normal, /SMask /None, /CA 1, /ca 1, /AIS false und /TK true
pv13 lehnt aktive Metadaten-Streams ab, weil /Type /Metadata und XMP-Komponentenmetadaten PDF 1.4 oder neuer erfordern
pv13 lehnt /EmbeddedFiles-Namensbäume des Dokuments ab, behält jedoch ältere eingebettete Datei-Stream-Referenzen bei, die den PDF 1.4-Namensbaum-Eintrag nicht verwenden
pv13 lehnt den /Lang-Eintrag im Dokumentkatalog ab, weil die Identifikation der natürlichen Sprache auf Dokumentebene PDF 1.4 oder neuer erfordert
pv14 und ältere Ziele lehnen /PageLayout /TwoPageLeft- und /TwoPageRight-Werte im Dokumentkatalog ab, weil Zweiseiten-Layouts PDF 1.5 oder neuer erfordern
pv14 und ältere Ziele lehnen Bild-XObjects mit /BitsPerComponent 16 ab, weil 16-Bit-Bildkomponenten PDF 1.5 oder neuer erfordern
pv14 und ältere Ziele lehnen /SMaskInData-Einträge in Bild-XObjects ab, weil eingebettete JPEG 2000-Softmask-Kanäle PDF 1.5 oder neuer erfordern
pv13 mit saIncremental löst EPdfError aus, weil die Normalisierung signierte frühere Revisionen nicht bewahren kann
Jede verschlüsselte Ausgabe mit expliziter Version löst EPdfError aus; Aufrufer müssen die Sicherheit entfernen, bevor sie ein Kernversions-Ziel anfordern
Entwickler-Erweiterungswörterbücher werden unabhängig von der effektiven Kernversion validiert, einschließlich escapeter PDF-Namen und strikter Ganzzahl-Stufen
PRC-3D-Streams erfordern eine /ADBE-Entwicklererweiterung mit /BaseVersion /1.7 und /ExtensionLevel 1 oder neuer; eine bloße PDF 1.7-Deklaration genügt nicht
RichMedia-Annotationen und RichMediaExecute-Aktionen erfordern eine /ADBE-Entwicklererweiterung mit /BaseVersion /1.7 und /ExtensionLevel 3 oder neuer
Georäumliche /Type /Measure /Subtype /GEO-Wörterbücher und Projection-Annotationen erfordern eine /ADBE-Entwicklererweiterung mit /BaseVersion /1.7 und /ExtensionLevel 3 oder neuer
Jedes über einen /Annots-Eintrag einer Seite erreichbare direkte oder indirekte Annotation-Wörterbuch muss die erforderlichen /Subtype- und /Rect-Einträge enthalten
Die Validierung von /OCProperties im Katalog erfordert das Array /OCGs, das Wörterbuch /D, bei Vorhandensein gültige /BaseState /ON- und /Intent /View-Standardwerte sowie die Array-Einträge /Configs, /ON, /OFF, /AS und /Order
Die Windows-V8-Bibliotheken ab v3.125.2 bewahren bearbeiteten XFA-Text über das Speichern von Packet-Arrays und unterstütztem Single-Stream-XDP, einschließlich leerem Text, ursprünglichem Whitespace, Zeilenumbrüchen und ergänzendem Unicode
Die Windows-V8-Bibliotheken ab v3.126.0 bewahren XML-Kommentare und Processing Instructions außerhalb der Live-Datasets und Formular-Pakete in unterstütztem Single-Stream-XDP, einschließlich UTF-8- und BOM-markierter UTF-16-Eingaben; Kommentare und Processing Instructions innerhalb ersetzter Live-Pakete, ungültige UTF-8- oder UTF-16-Kodierung, unvollständige Tags, ungültige Entity-Referenzen, fehlerhafte Processing Instructions, DTD-Deklarationen und XMLDSig werden zurückgewiesen, bevor der persistente XFA-Stream verändert wird
Die Windows-V8-Bibliotheken ab v3.126.2 weisen zusätzlich fehlerhafte Attribut-Abstände, unquotete Werte, duplizierte lexikalische oder namespace-expandierte Attribute, ungebundene oder reservierte Namespace-Präfixe, ungültige qualifizierte Namen, fehlplatzierte Deklarationen, ungültige Deklarationsreihenfolge und -werte sowie Deklarationen, deren Kodierung nicht zu den Eingabebytes passt, zurück, bevor der persistente Stream verändert wird
Diese begrenzten XML-1.0-Speicher-Wächter bieten keine Schema-Validierung, kein DTD-Support, kein XMLDSig-Rewriting und keine allgemeine XML-1.1-Unterstützung; ergänzender Unicode wird in Text- und Attributwerten unterstützt, Element- und Attributnamen bleiben auf die BMP-Namensunterstützung der nativen DOM beschränkt
Weitere unterstützte Paket-Elemente und Root-Namespaces werden semantisch erhalten; die Ausgabe nutzt UTF-8, ohne eine byte-identische XML-Erhaltung zu garantieren
Die V8-Bibliotheken ab v3.125.2 melden XFA-Paket-Exportfehler, ohne den Änderungszustand zu löschen; das Scheitern des letzten gepufferten Schreibvorgangs melden jene V8-Bibliotheken und die ordentlichen Windows-Bibliotheken ab v3.125.3 als fehlgeschlagenes Speichern
Dateispeicherungen verwenden eine temporäre Datei im selben Verzeichnis und ersetzen das Ziel erst, nachdem die Nachbearbeitung erfolgreich war
Die Nachbearbeitung mit expliziter Version dekodiert PNG-Predictors, die im direkten /DecodeParms-Wörterbuch des Streams oder in einem Ein-Element-Parameterarray deklariert sind, einschließlich predictor-komprimierter Cross-Reference-Streams in Formularen mit mehreren Seiten; unrelated verschachtelte Schlüssel überschreiben die Dekodierparameter des Streams nicht

Beispiel

// In Datei speichern
Pdf.SaveAs('output.pdf');

// In Stream speichern
var MS: TMemoryStream;
MS := TMemoryStream.Create;
try
  Pdf.SaveAs(MS);
  MS.SaveToFile('output.pdf');
finally
  MS.Free;
end;

Siehe auch

LoadDocument, Compressed, CreateDocument

SaveAs Methode