SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Komponent: TPdf · Enhed: PDFium

Gemmer den aktive PDF til en filsti, mens tilknyttede filer injiceres i kataloget eller siderne i overensstemmelse med 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

Returnerer True, hvis PDF'en med de injicerede tilknyttede filer blev gemt med succes, eller False ved fejl

Description

SaveAsWithAssociateFiles implementerer PDF 2.0-Associate-Files-injektion (ISO 32000-2 §7.11.4)

Metoden knytter filer såsom XML-data, kildeskemaer eller skabeloner til kataloget eller individuelle sider med eksplicit /AFRelationship-metadata

TAssociateFile.Description skriver den menneskelæsbare fil-specifikations-/Desc-værdi, der bruges af tilgængeligheds- og opdagelses-workflows

Remarks

Injektion af klartekst-filespec-objekter i et krypteret dokument ville beskadige det, så denne metode fjerner automatisk alle eksisterende sikkerhedsindstillinger under serialisering (svarer til at bruge saRemoveSecurity)
Filer leveres via TAssocFilesOptions-strukturen, som angiver filnavne, indholdsarrays, MIME-typer og relationer

Example

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

  F.FileName := 'data.xml';
  F.Description := 'Source data for this document';
  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 metode