AddPDFA3AssociatedFileFromString

Właściwości dokumentu

Opis

Tworzy strumień osadzonego pliku z bajtów w pamięci, dodaje specyfikację pliku do drzewa nazw załączników dokumentu i rejestruje ją w tablicy /AF Catalog na potrzeby przepływów pracy PDF/A-3

Składnia

Delphi

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

Parametry

FileName	Wyświetlana nazwa pliku załącznika, na przykład `invoice.xml`
MIMEType	Typ MIME zapisywany w strumieniu osadzonego pliku, na przykład `text/xml` lub `application/xml`
Description	Opcjonalny tekst `/Desc` zapisywany w specyfikacji pliku
Relationship	Wartość `/AFRelationship`, zwykle `Source`, `Data`, `Alternative`, `Supplement` lub `Unspecified`
FileBytes	Surowe bajty do zapisania w strumieniu osadzonego pliku

Wartości zwracane

0	Brak aktywnego dokumentu, nieprawidłowe parametry albo bieżący dokument nie działa w trybie PDF/A-3
Non-zero	Uchwyt obiektu nowo utworzonej specyfikacji pliku

Uwagi

Plik jest widoczny na liście załączników dokumentu i jest również wskazywany przez tablicę /AF Catalog wymaganą dla plików powiązanych PDF/A-3

W przypadku standardowego pliku XML faktury Factur-X, ZUGFeRD lub XRechnung preferuj AddFacturXAssociatedFileFromString, aby metadane faktury i kontrole profilu były zapisywane spójnie

Przykład

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

Zobacz również

AddFacturXAssociatedFileFromString, SetPDFAMode, SetEmbeddedFileAFRelationship, AddEmbeddedFile