SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Uloží aktívny súbor PDF do umiestnenia súboru a zároveň vloží pridružené súbory do katalógu alebo stránok v súlade s ISO 32000-2 §7.11.4

Syntax

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

FileName	string. Cieľová výstupná cesta k súboru
Options	TAssocFilesOptions. Voľby vloženia podrobne určujúce súbory, metadáta a cieľový bod pripojenia v katalógu alebo na strane

Return Value

Vráti True, ak sa PDF s vloženými associate files úspešne uložilo, inak False

Description

SaveAsWithAssociateFiles implementuje vkladanie Associate Files podľa PDF 2.0 (ISO 32000-2 §7.11.4)

Metóda pripája súbory ako XML dáta, zdrojové schémy alebo šablóny ku katalógu alebo jednotlivým stranám s explicitnými metadátami /AFRelationship

TAssociateFile.Description zapisuje ľudsky čitateľnú hodnotu /Desc špecifikácie súboru používanú workflow prístupnosti a objavovania

Remarks

Vloženie objektov filespec v čistom texte do šifrovaného dokumentu by ho poškodilo, preto táto metóda počas serializácie automaticky odstráni všetky existujúce voľby zabezpečenia (ekvivalent použitia saRemoveSecurity)
Súbory sa dodávajú cez štruktúru TAssocFilesOptions, ktorá určuje názvy súborov, polia obsahu, typy MIME a vzťahy

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;

Metóda SaveAsWithAssociateFiles