Docs de PDFiumPas

SaveAs Método

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.
Componente: TPdf  ·  Unidad: PDFium
Guarda una copia del documento PDF en el flujo indicado. Si PdfVersion es pv13 a pv17, la salida guardada se normaliza y valida para esa versión de destino, incluidas las anulaciones existentes de /Version del catálogo en la salida incremental. El validador cubre toda la cronología de funciones de PDF 1.1–1.7 / ISO 32000-1: filtros (FlateDecode, JBIG2Decode, JPXDecode), flujos de objeto y xref, transparencia (SMask, ca/CA, modos de fusión), Tagged PDF (StructTreeRoot, MarkInfo), espacios de color (ICCBased, DeviceN), cuadros de página (BleedBox/TrimBox/ArtBox), intents de salida, contenido opcional, AcroForm, fuentes CID/Type 0 y OpenType, cifrado AES y AES-256 (CFM AESV2/AESV3), todos los subtipos de anotación restringidos por versión (Widget, Sound, Movie, FreeText, Line, Square, Circle, Highlight, Underline, StrikeOut, Stamp, Ink, Popup, FileAttachment, TrapNet, Squiggly, PrinterMark, Polygon, PolyLine, Caret, Screen, Watermark, 3D, Redact), tipos de acción restringidos por versión (SubmitForm, ResetForm, ImportData, Hide, Named, JavaScript, Trans, SetState, Rendition, GoToE, GoTo3DView) y entradas de catálogo (Perms, Legal, Collection, Requirements, NeedsRendering). Cualquier cosa que supere la versión de destino elegida genera EPdfError. Si el documento no tiene un OpenAction existente y la versión de destino lo admite, el PDF guardado se abre en la primera página con zoom Ajustar altura. Las compilaciones de prueba aplican la marca de agua de prueba durante el guardado

Sintaxis

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

StreamTStream. Un TStream en el que escribir los datos PDF
OptionTSaveOption. Opción de guardado: soNone para una reescritura completa, o soIncremental para una actualización incremental anexada al archivo
PdfVersionTPdfVersion. Versión PDF de destino. Usa pvUnknown para conservar la versión actual

 

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

FileNamestring. Ruta del archivo de salida. El archivo se crea o se sobrescribe
OptionTSaveOption. Opción de guardado: soNone para una reescritura completa, o soIncremental para una actualización incremental anexada al archivo
PdfVersionTPdfVersion. Versión PDF de destino. Usa pvUnknown para conservar la versión actual

Return Value

Devuelve True si el documento se guardó correctamente, o False si falló

Descripción

Guarda el documento actual en una ruta de archivo o en un TStream. El parámetro Option controla el modo de guardado: soNone realiza una reescritura completa del archivo, mientras que soIncremental anexa solo los cambios realizados desde el último guardado del documento (salida más pequeña, pero crece con guardados repetidos)

El parámetro PdfVersion especifica la versión PDF de salida; pasa pvUnknown para conservar la versión existente del documento

La propiedad Compressed controla si se aplica compresión de object-stream durante el guardado

Ejemplo

// guardar en archivo
Pdf.SaveAs('output.pdf');

// guardar en flujo
var MS: TMemoryStream;
MS := TMemoryStream.Create;
try
  Pdf.SaveAs(MS);
  MS.SaveToFile('output.pdf');
finally
  MS.Free;
end;

Véase también

LoadDocument, Compressed, CreateDocument