AddPDFA3AssociatedFileFromString

Document properties

Description

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

Syntax

Delphi

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

Parameters

FileNameПоказваното име на файла за прикачения файл, като например invoice.xml
MIMETypeMIME типът, записан във вградения файлов поток, като например text/xml или application/xml
DescriptionНезадължителният /Desc текст, записан в спецификацията на файла
RelationshipСтойността на /AFRelationship, обикновено Source, Data, Alternative, Supplement или Unspecified
FileBytesСуровите байтове за съхранение в потока на вградения файл

Return values

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

Remarks

Файлът е видим в списъка с прикачени файлове към документа и също така се препраща от масива /AF в каталога, изискван от асоциираните файлове на PDF/A-3

За стандартна Factur-X, ZUGFeRD, или XRechnung XML фактура, предпочитайте AddFacturXAssociatedFileFromString, така че метаданните на фактурата и проверките на профила да се записват последователно

Example

// 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;

See also

AddFacturXAssociatedFileFromString, SetPDFAMode, SetEmbeddedFileAFRelationship, AddEmbeddedFile