SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Composant: TPdf · Unit: PDFium

Sauvegarde le PDF actif vers un chemin de fichier en injectant des fichiers associés dans le catalogue ou les pages conformément à ISO 32000-2 §7.11.4

Syntax

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

FileName	string. Le chemin de fichier de sortie cible
Options	TAssocFilesOptions. Options d’injection détaillant les fichiers, métadonnées et le point d’attache cible de catalogue ou de page

Return Value

Renvoie True si le PDF avec fichiers associés injectés a été sauvegardé avec succès, ou False en cas d’échec

Description

SaveAsWithAssociateFiles implements PDF 2.0 Associate Files injection (ISO 32000-2 §7.11.4)

La méthode attache des fichiers tels que des données XML, des schémas source ou des modèles au catalogue ou à des pages individuelles avec des métadonnées /AFRelationship explicites

TAssociateFile.Description écrit la valeur /Desc de spécification de fichier lisible utilisée par les flux de travail d’accessibilité et de découverte

Remarks

Injecter des objets filespec en texte clair dans un document chiffré le corromprait, donc cette méthode supprime automatiquement toutes les options de sécurité existantes pendant la sérialisation (équivalent à utiliser saRemoveSecurity)
Les fichiers sont fournis via la structure TAssocFilesOptions, spécifiant les noms de fichier, les tableaux de contenu, les types MIME et les relations

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 Méthode