PDFiumPas-kehittäjäviite

Component: TPdf · Unit: PDFium

Tallentaa PDF-dokumentin kopion määritettyyn virtaan. Jos PdfVersion on pv13:sta pv17:ään, tallennettu tulos normalisoidaan ja validoidaan kyseistä kohdeversiota vasten, mukaan lukien olemassa olevat katalogin /Version-ohitukset inkrementaalisessa tulosteessa. Validoija kattaa koko PDF 1.1–1.7 / ISO 32000-1 -ominaisuushistorian: suodattimet (FlateDecode, JBIG2Decode, JPXDecode), object- ja xref-virrat, läpinäkyvyys (SMask, ca/CA, blend modes), Tagged PDF (StructTreeRoot, MarkInfo), väriavaruudet (ICCBased, DeviceN), sivulaatikot (BleedBox/TrimBox/ArtBox), output intents, optional content, AcroForm, CID/Type 0- ja OpenType-fontit, AES- ja AES-256-salaus (CFM AESV2/AESV3), kaikki versiosidonnaiset annotation-alatyypit (Widget, Sound, Movie, FreeText, Line, Square, Circle, Highlight, Underline, StrikeOut, Stamp, Ink, Popup, FileAttachment, TrapNet, Squiggly, PrinterMark, Polygon, PolyLine, Caret, Screen, Watermark, 3D, Redact), versiosidonnaiset action-tyypit (SubmitForm, ResetForm, ImportData, Hide, Named, JavaScript, Trans, SetState, Rendition, GoToE, GoTo3DView) sekä katalogimerkinnät (Perms, Legal, Collection, Requirements, NeedsRendering). Kaikki, mikä ylittää valitun kohdeversion, aiheuttaa EPdfErrorin. Jos dokumentissa ei ole olemassa olevaa OpenActionia ja kohdeversio tukee sitä, tallennettu PDF aukeaa ensimmäiselle sivulle Fit Height -suurennuksella. Trial-buildit lisäävät trial-vesileiman tallennuksen aikana

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-metodi