PDFium Component Docs

SaveAs-metode

Component: TPdf  ·  Unit: PDFium
Lagrer en kopi av PDF-dokumentet til den angitte strømmen. Hvis PdfVersion er pv13 til pv17, blir den lagrede utdataen normalisert og validert for den målversjonen, inkludert eksisterende catalog /Version-overstyringer i inkrementell utdata. Validatoren dekker hele funksjonstidslinjen i PDF 1.1–1.7 / ISO 32000-1: filtre (FlateDecode, JBIG2Decode, JPXDecode), object- og xref-strømmer, transparens (SMask, ca/CA, blend modes), Tagged PDF (StructTreeRoot, MarkInfo), fargerom (ICCBased, DeviceN), sidebokser (BleedBox/TrimBox/ArtBox), output intents, optional content, AcroForm, CID/Type 0- og OpenType-skrifter, AES- og AES-256-kryptering (CFM AESV2/AESV3), alle versjonsbegrensede annotasjonstyper (Widget, Sound, Movie, FreeText, Line, Square, Circle, Highlight, Underline, StrikeOut, Stamp, Ink, Popup, FileAttachment, TrapNet, Squiggly, PrinterMark, Polygon, PolyLine, Caret, Screen, Watermark, 3D, Redact), versjonsbegrensede handlingstyper (SubmitForm, ResetForm, ImportData, Hide, Named, JavaScript, Trans, SetState, Rendition, GoToE, GoTo3DView) og katalogoppføringer (Perms, Legal, Collection, Requirements, NeedsRendering). Alt som overstiger den valgte målversjonen utløser EPdfError. Hvis dokumentet ikke har noen eksisterende OpenAction og målversjonen støtter det, åpnes den lagrede PDF-en på første side med Fit Height-zoom. Prøveversjoner legger på prøvevannmerket under lagring

Syntax

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

StreamTStream value that receives the PDF data
OptionTSaveOption. 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
PdfVersionTPdfVersion target; use pvUnknown to preserve the current version

 

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

FileNamestring. The output file path. A sibling temporary file is completed first, then atomically replaces the destination
OptionTSaveOption. Save option: saNone, saIncremental, saNoIncremental, or saRemoveSecurity
PdfVersionTPdfVersion 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

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;

See Also

LoadDocument, Compressed, CreateDocument