SaveAsWithAssociateFiles - TPdf

Componente: TPdf · Unidad: PDFium

Guarda el PDF activo en una ruta de archivo inyectando archivos asociados en el catálogo o en las páginas de conformidad con ISO 32000-2 §7.11.4

Syntax

function SaveAsWithAssociateFiles(const FileName: string; const Options: TAssocFilesOptions): Boolean;

FileName	string. The target output file path
Options	TAssocFilesOptions. Injection options detailing files, metadata, and the target catalog or page attachment point

Return Value

Devuelve True si el PDF con los archivos asociados inyectados se guardó correctamente, o False en caso de fallo

Description

SaveAsWithAssociateFiles implementa la inyección de Associate Files de PDF 2.0 (ISO 32000-2 §7.11.4)

El método adjunta archivos como datos XML, esquemas de origen o plantillas al catálogo o a páginas individuales con metadatos /AFRelationship explícitos

TAssociateFile.Description escribe el valor /Desc de la especificación de archivo legible por humanos, usado por los flujos de trabajo de accesibilidad y detección

Remarks

Inyectar objetos filespec en texto sin cifrar en un documento cifrado lo corrompería, por lo que este método elimina automáticamente cualquier opción de seguridad existente durante la serialización (equivalente a usar saRemoveSecurity)
Los archivos se suministran mediante la estructura TAssocFilesOptions, que especifica nombres de archivo, arreglos de contenido, tipos MIME y relaciones

Example

var
  Opts: TAssocFilesOptions;
  F: TAssociateFile;
begin
  Opts := TAssocFilesOptions.Default;
  Opts.TargetPage := 0; // catalog-level attachment

  F.FileName := 'data.xml';
  F.Content := GetXmlBytes;
  F.Relationship := afData;
  F.MIMEType := 'text/xml';

  SetLength(Opts.Files, 1);
  Opts.Files[0] := F;

  if Pdf1.SaveAsWithAssociateFiles('output.pdf', Opts) then
    ShowMessage('PDF with associate files saved successfully');
end;

SaveAsWithAssociateFiles Método