SaveAs - TPdf - PDFiumPas

Component: TPdf · Unit: PDFium

Sparar en kopia av PDF-dokumentet till den angivna strömmen. Om PdfVersion är pv13 till pv17 normaliseras och valideras det sparade resultatet för den målversionen, inklusive befintliga katalogöverskrivningar av /Version i inkrementell utmatning. Valideraren täcker hela PDF 1.1–1.7 / ISO 32000-1-funktionslinjen: filter (FlateDecode, JBIG2Decode, JPXDecode), objekt- och xref-strömmar, transparens (SMask, ca/CA, blend modes), Tagged PDF (StructTreeRoot, MarkInfo), färgrymder (ICCBased, DeviceN), sidrutor (BleedBox/TrimBox/ArtBox), output intents, optional content, AcroForm, CID/Type 0- och OpenType-teckensnitt, AES- och AES-256-kryptering (CFM AESV2/AESV3), alla versionsbegränsade annoteringssubtyper (Widget, Sound, Movie, FreeText, Line, Square, Circle, Highlight, Underline, StrikeOut, Stamp, Ink, Popup, FileAttachment, TrapNet, Squiggly, PrinterMark, Polygon, PolyLine, Caret, Screen, Watermark, 3D, Redact), versionsbegränsade åtgärdstyper (SubmitForm, ResetForm, ImportData, Hide, Named, JavaScript, Trans, SetState, Rendition, GoToE, GoTo3DView) och katalogposter (Perms, Legal, Collection, Requirements, NeedsRendering). Allt som överskrider vald målversion kastar EPdfError. Om dokumentet inte har någon befintlig OpenAction och målversionen stöder det öppnas den sparade PDF-filen på första sidan med Fit Height-zoom. Testversioner lägger till testvattenstämpeln under sparningen

Syntax

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

Stream	TStream value that receives the PDF data
Option	TSaveOption. Save option: `saNone` for a normal save, `saIncremental` for an incremental update, `saNoIncremental` to force a full rewrite, or `saRemoveSecurity` to remove security while saving
PdfVersion	TPdfVersion target; use `pvUnknown` to preserve the current version

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

FileName	string. The output file path. A sibling temporary file is completed first, then atomically replaces the destination
Option	TSaveOption. Save option: `saNone`, `saIncremental`, `saNoIncremental`, or `saRemoveSecurity`
PdfVersion	TPdfVersion target; use `pvUnknown` to preserve the current version

Return Value

Returns True if the document was saved successfully, or False on failure.

Description

Saves the current document to a file path or a TStream

The PdfVersion parameter specifies the output PDF version; pass pvUnknown to keep the document's existing version

The Compressed property controls stream compression. Hybrid-reference, xref-stream and object-stream inputs are preserved when a classic-xref rewrite cannot retain their complete cross-reference semantics

Explicit PDF-version checks follow the active cross-reference revision chain and active object-stream members, so stale or unreferenced object bodies do not affect the requested version gate

The file overload leaves an existing destination unchanged if compression, post-processing or version validation fails

Conformance behaviour

pv13 normalizes inherited page resources, canonicalizes /ProcSet and removes only default transparency-state entries
pv13 rejects active metadata streams because /Type /Metadata and XMP component metadata require PDF 1.4 or newer
pv13 rejects document /EmbeddedFiles name trees while retaining older embedded-file stream references that do not use the PDF 1.4 name-tree entry
pv13 rejects the document catalog /Lang entry because document-level natural-language identification requires PDF 1.4 or newer
pv14 and older targets reject document catalog /PageLayout /TwoPageLeft and /TwoPageRight values because two-page layouts require PDF 1.5 or newer
pv14 and older targets reject image XObjects with /BitsPerComponent 16 because 16-bit image components require PDF 1.5 or newer
pv14 and older targets reject image XObject /SMaskInData entries because embedded JPEG 2000 soft-mask channels require PDF 1.5 or newer
pv13 with saIncremental raises EPdfError because normalization cannot preserve signed prior revisions
Any encrypted explicit-version output raises EPdfError; callers must remove security before requesting a core-version target
Developer-extension dictionaries are validated independently from the effective core version, including escaped PDF names and strict integer levels
PRC 3D streams require an /ADBE developer extension with /BaseVersion /1.7 and /ExtensionLevel 1 or newer; a bare PDF 1.7 declaration is insufficient
RichMedia annotations and RichMediaExecute actions require an /ADBE developer extension with /BaseVersion /1.7 and /ExtensionLevel 3 or newer
Geospatial /Type /Measure /Subtype /GEO dictionaries and Projection annotations require an /ADBE developer extension with /BaseVersion /1.7 and /ExtensionLevel 3 or newer
Every direct or indirect annotation dictionary reached through a Page /Annots entry must contain the required /Subtype and /Rect entries
Catalog /OCProperties validation requires array /OCGs, dictionary /D, valid default /BaseState /ON and /Intent /View values when present, and array-valued /Configs, /ON, /OFF, /AS, and /Order entries
File saves use a same-directory temporary file and replace the destination only after post-processing succeeds

Example

// Save to file
Pdf.SaveAs('output.pdf');

// Save to stream
var MS: TMemoryStream;
MS := TMemoryStream.Create;
try
  Pdf.SaveAs(MS);
  MS.SaveToFile('output.pdf');
finally
  MS.Free;
end;

SaveAs Metod