SaveAsWithAssociateFiles - TPdf - PDFium Delphi Component

Компонент: TPdf · Модул: PDFium

Записва активния PDF във файл път, като вмъква свързани файлове в каталога или страниците съгласно ISO 32000-2 §7.11.4

Синтаксис

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

FileName	string. Пътят на целевия изходен файл
Options	TAssocFilesOptions. Опции за вмъкване, описващи файлове, метаданни и точката на прикачване - целеви каталог или страница

Върната стойност

Връща True, ако PDF с вмъкнати свързани файлове е записан успешно, или False при неуспех

Описание

SaveAsWithAssociateFiles имплементира вмъкване на Associate Files по PDF 2.0 (ISO 32000-2 §7.11.4)

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

TAssociateFile.Description записва човешки четимата стойност /Desc на file спецификацията, използвана от работни процеси за достъпност и откриваемост

Забележки

Вмъкването на filespec обекти в чист текст в криптиран документ би го развалило, затова методът автоматично премахва всяка съществуваща опция за сигурност по време на сериализацията (еквивалентно на използване на saRemoveSecurity)
Файловете се подават чрез структурата TAssocFilesOptions, указваща имена на файлове, масиви със съдържание, MIME типове и връзки

Пример

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;

Виж също

SaveAsWithAssociateFilesToStream, SaveAs

метод SaveAsWithAssociateFiles