PDFium Component Docs

מתודת SaveAs

Component: TPdf  ·  Unit: PDFium
שומר את עותק מסמך ה-PDF אל ה-stream שצוין. אם PdfVersion הוא pv13 עד pv17, הפלט הנשמר מנורמל ונבדק עבור גרסת היעד הזו, כולל עקיפות קיימות של /Version ב-catalog בפלט אינקרמנטלי. המאמת מכסה את כל ציר התכונות של PDF 1.1–1.7 / ISO 32000-1: filters (FlateDecode, JBIG2Decode, JPXDecode), object & xref streams, transparency (SMask, ca/CA, blend modes), Tagged PDF (StructTreeRoot, MarkInfo), color spaces (ICCBased, DeviceN), page boxes (BleedBox/TrimBox/ArtBox), output intents, optional content, AcroForm, גופני CID/Type 0 ו-OpenType, הצפנת AES & AES-256 ‏(CFM AESV2/AESV3), כל תתי-הסוג של annotations המוגבלים לפי גרסה (Widget, Sound, Movie, FreeText, Line, Square, Circle, Highlight, Underline, StrikeOut, Stamp, Ink, Popup, FileAttachment, TrapNet, Squiggly, PrinterMark, Polygon, PolyLine, Caret, Screen, Watermark, 3D, Redact), סוגי actions המוגבלים לפי גרסה (SubmitForm, ResetForm, ImportData, Hide, Named, JavaScript, Trans, SetState, Rendition, GoToE, GoTo3DView), ורשומות catalog (Perms, Legal, Collection, Requirements, NeedsRendering). כל מה שחורג מגרסת היעד שנבחרה מעלה EPdfError. אם למסמך אין OpenAction קיים וגרסת היעד תומכת בכך, ה-PDF הנשמר נפתח בעמוד הראשון עם זום Fit Height. בניות Trial מחילות את סימן המים של trial בעת השמירה

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

מחזיר True אם המסמך נשמר בהצלחה, או 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

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