SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Зберігає активний PDF за шляхом до файлу з впровадженням супутніх файлів у каталог або сторінки відповідно до ISO 32000-2 §7.11.4

Syntax

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

FileName	string. Шлях до цільового вихідного файлу
Options	TAssocFilesOptions. Параметри впровадження, що деталізують файли, метадані та точку приєднання в каталозі або на сторінці

Return Value

Повертає True, якщо PDF із впровадженими супутніми файлами успішно збережено, або False у разі помилки

Description

SaveAsWithAssociateFiles реалізує впровадження Associate Files з PDF 2.0 (ISO 32000-2 §7.11.4)

Метод приєднує файли, як-от XML-дані, вихідні схеми чи шаблони, до каталогу або окремих сторінок із явними метаданими /AFRelationship

TAssociateFile.Description записує зчитуване людиною значення /Desc специфікації файлу, яке використовують робочі процеси доступності та виявлення

Remarks

Впровадження об'єктів 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 метод