SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Sparar den aktiva PDF-filen till en sökväg och bäddar in tillhörande filer i dokumentkatalogen (catalog) eller sidor i enlighet med ISO 32000-2 §7.11.4

Syntax

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

FileName	string. Målsökväg för utmatningsfilen
Options	TAssocFilesOptions. Injektionsalternativ som beskriver filer, metadata samt katalog- eller sidfästpunkten som mål

Return Value

Returnerar True om PDF-filen med injicerade associerade filer sparades, eller False vid fel

Description

SaveAsWithAssociateFiles implementerar injicering av PDF 2.0 Associate Files (ISO 32000-2 §7.11.4)

Metoden fäster filer som XML-data, källscheman eller mallar vid katalogen eller enskilda sidor med explicit /AFRelationship-metadata

TAssociateFile.Description skriver det läsbara /Desc-värdet i filspecifikationen, vilket används av arbetsflöden för tillgänglighet och identifiering

Remarks

Att injicera klartexta filespec-objekt i ett krypterat dokument skulle skada det, därför tar metoden automatiskt bort alla befintliga säkerhetsalternativ under serialiseringen (motsvarar att använda saRemoveSecurity)
Filerna tillhandahålls via strukturen TAssocFilesOptions, som anger filnamn, innehållsarrayer, MIME-typer och relationer

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 metod