SaveAs - TPdf - PDFiumPas

Component: TPdf · Unit: PDFium

Shrani kopijo dokumenta PDF v navedeni tok. Če je PdfVersion od pv13 do pv17, se shranjeni izhod normalizira in preveri za to ciljno različico, vključno z morebitnimi obstoječimi preglasitvami /Version v inkrementalnem izhodu. Preverjevalnik pokriva celotno časovnico zmožnosti PDF 1.1–1.7 / ISO 32000-1: filtri (FlateDecode, JBIG2Decode, JPXDecode), objektske in xref tokove, prosojnost (SMask, ca/CA, načini mešanja), Tagged PDF (StructTreeRoot, MarkInfo), barvne prostore (ICCBased, DeviceN), stranične okvirje (BleedBox/TrimBox/ArtBox), output intent, izbirno vsebino, AcroForm, pisave CID/Type 0 in OpenType, šifriranje AES in AES-256 (CFM AESV2/AESV3), vse podvrste opomb z omejitvijo različice (Widget, Sound, Movie, FreeText, Line, Square, Circle, Highlight, Underline, StrikeOut, Stamp, Ink, Popup, FileAttachment, TrapNet, Squiggly, PrinterMark, Polygon, PolyLine, Caret, Screen, Watermark, 3D, Redact), vrste dejanj z omejitvijo različice (SubmitForm, ResetForm, ImportData, Hide, Named, JavaScript, Trans, SetState, Rendition, GoToE, GoTo3DView) in vnose kataloga (Perms, Legal, Collection, Requirements, NeedsRendering). Vse, kar presega izbrano ciljno različico, sproži EPdfError. Če dokument nima obstoječega OpenAction in ga ciljna različica podpira, se shranjeni PDF odpre na prvi strani z lupo Fit Height. Preizkusne izdaje med shranjevanjem uporabijo preizkusni vodni žig

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

Vrne True, če je bil dokument uspešno shranjen, sicer False

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 method