SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Компонент: TPdf · Модуль: 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 реализует внедрение связанных файлов PDF 2.0 (ISO 32000-2 §7.11.4)

Метод прикрепляет файлы, такие как данные XML, исходные схемы или шаблоны, к каталогу или отдельным страницам с явными метаданными /AFRelationship

TAssociateFile.Description записывает читаемое человеком значение /Desc спецификации файла, используемое в сценариях доступности и обнаружения

Remarks

Внедрение объектов спецификации файлов открытого текста в зашифрованный документ повредило бы его, поэтому данный метод автоматически удаляет любые существующие параметры безопасности во время сериализации (эквивалентно использованию 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 Метод