Propriedade AttachmentRelationship

Os associated files do PDF 2.0 (ISO 32000-2 §7.11.4) marcam cada file specification com um nome /AFRelationship que indica como o ficheiro incorporado se relaciona com o conteúdo a que está anexado: Source, Data, Alternative, Supplement, EncryptedPayload, FormData, Schema ou Unspecified (Table 43). As faturas PDF/A-3 e ZUGFeRD / Factur-X dependem desta entrada para marcar o payload XML legível por máquina

A propriedade lê a entrada através da exportação nativa FPDFAttachment_GetAFRelationship e devolve o token de nome em bruto como uma string Unicode. Devolve uma cadeia vazia quando a file specification não tem entrada /AFRelationship, quando a entrada não é um nome ou quando o pdfium.dll carregado é anterior à exportação (ver AttachmentRelationshipFeaturesAvailable)

A propriedade é só de leitura. Para anexar ficheiros com uma relationship use o escritor do lado Pascal em FPdfAssocFiles, que emite os mesmos tokens de nome

• Só os anexos registados na árvore de nomes /EmbeddedFiles têm índice; um ficheiro associado referenciado apenas por um array /AF não é alcançável através desta propriedade (ver AttachmentCount)
• O nome é devolvido exatamente como está escrito no ficheiro; compare-o de forma case-sensitive com os tokens do ISO 32000-2
• ReadAttachmentMetadata captura o mesmo valor para todos os anexos numa única passagem nativa através do campo Relationship de TPdfAttachmentMetadata, e TryGetAnnotationFileAttachment preenche o campo correspondente para anotações de anexo de ficheiro
• Um resultado vazio não distingue "sem entrada" de "sem exportação"; consulte AttachmentRelationshipFeaturesAvailable quando essa distinção fizer diferença