AddPDFA3AssociatedFileFromString

Propriedades do documento

Descrição

Cria um fluxo de ficheiro incorporado a partir de bytes em memória, adiciona a especificação do ficheiro à árvore de nomes de anexos do documento e regista-a na matriz /AF do Catalog para fluxos PDF/A-3

Sintaxe

Delphi

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

Parâmetros

FileName	O nome de ficheiro apresentado para o anexo, como `invoice.xml`
MIMEType	O tipo MIME escrito no fluxo do ficheiro incorporado, como `text/xml` ou `application/xml`
Description	O texto `/Desc` opcional escrito na especificação de ficheiro
Relationship	O valor `/AFRelationship`, geralmente `Source`, `Data`, `Alternative`, `Supplement` ou `Unspecified`
FileBytes	Os bytes em bruto a armazenar no fluxo do ficheiro incorporado

Valores devolvidos

0	Nenhum documento ativo, parâmetros inválidos ou o documento atual não está num modo PDF/A-3
Non-zero	O identificador do objeto da especificação de ficheiro recém-criada

Observações

O ficheiro é visível na lista de anexos do documento e também é referenciado pela matriz /AF do Catalog exigida pelos ficheiros associados PDF/A-3

Para XML de faturas Factur-X, ZUGFeRD ou XRechnung padrão, prefira AddFacturXAssociatedFileFromString para que os metadados da fatura e as verificações de perfil sejam escritos de forma consistente

Exemplo

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

Consulte também

AddFacturXAssociatedFileFromString, SetPDFAMode, SetEmbeddedFileAFRelationship, AddEmbeddedFile