AddPDFA3AssociatedFileFromString

Свойства документа

Описание

Создает поток внедренного файла из байтов в памяти, добавляет спецификацию файла в дерево имен вложений документа и регистрирует ее в массиве /AF каталога для сценариев PDF/A-3

Синтаксис

Delphi

Function TPDFlib.AddPDFA3AssociatedFileFromString(Const FileName, MIMEType, Description, Relationship: WideString; Const FileBytes: AnsiString): Integer;

Параметры

FileName	Отображаемое имя файла вложения, например `invoice.xml`
MIMEType	MIME-тип, записываемый в поток внедренного файла, например `text/xml` или `application/xml`
Description	Необязательный текст `/Desc`, записываемый в файловую спецификацию
Relationship	Значение `/AFRelationship`, обычно `Source`, `Data`, `Alternative`, `Supplement` или `Unspecified`
FileBytes	Сырые байты для записи в поток встроенного файла

Возвращаемые значения

0	Нет активного документа, параметры недействительны либо текущий документ не находится в режиме PDF/A-3
Non-zero	Дескриптор объекта созданной файловой спецификации

Примечания

Файл виден в списке вложений документа и одновременно упомянут в массиве /AF каталога, требуемом связанными файлами PDF/A-3

Для стандартного инвойсного XML Factur-X, ZUGFeRD или XRechnung предпочтительнее AddFacturXAssociatedFileFromString: метаданные инвойса и проверки профиля записываются согласованно

Пример

// Attach source XML to a PDF/A-3b document
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);
  PDF.NewDocument;
  FileID := PDF.AddPDFA3AssociatedFileFromString(
    'invoice.xml',
    'text/xml',
    'Invoice source data',
    'Source',
    InvoiceXML);
  if FileID = 0 then Exit;
  PDF.SaveToFile('archive.pdf');
end;

См. также

AddFacturXAssociatedFileFromString, SetPDFAMode, SetEmbeddedFileAFRelationship, AddEmbeddedFile