SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Saves the active PDF to a file path while injecting associated files into the catalog or pages conforming to ISO 32000-2 §7.11.4

Syntax

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

FileName	string. Η διαδρομή αρχείου εξόδου στόχου
Options	TAssocFilesOptions. Επιλογές έγχυσης που περιγράφουν αρχεία, μεταδεδομένα και το σημείο προσάρτησης καταλόγου ή σελίδας στόχου

Return Value

Returns True αν το PDF με εγχυμένα σχετικά αρχεία αποθηκεύτηκε επιτυχώς, ή False σε αποτυχία

Description

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

Η μέθοδος προσαρτά αρχεία όπως δεδομένα XML, σχήματα πηγής ή πρότυπα στον κατάλογο ή μεμονωμένες σελίδες με ρητά μεταδεδομένα /AFRelationship

TAssociateFile.Description γράφει την αναγνώσιμη από άνθρωπο τιμή προδιαγραφής αρχείου /Desc που χρησιμοποιούν ροές εργασίας προσβασιμότητας και ανακάλυψης

Remarks

Η έγχυση plaintext αντικειμένων filespec σε κρυπτογραφημένο έγγραφο θα το διέφθειρε, οπότε αυτή η μέθοδος αφαιρεί αυτόματα τυχόν υπάρχουσες επιλογές ασφαλείας κατά τη σειριοποίηση (ισοδύναμο με χρήση saRemoveSecurity)
Τα αρχεία παρέχονται μέσω της δομής TAssocFilesOptions ορίζοντας ονόματα αρχείων, πίνακες περιεχομένου, τύπους MIME και σχέσεις

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