TPdf.AttachmentRelationship - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Geeft de /AFRelationship-naam terug van het ingesloten bestand op de opgegeven index op basis van 0, of een lege tekenreeks als de file specification die niet heeft

Syntax

property AttachmentRelationship[Index: Integer]: WString; // read only

Description

Associated files in PDF 2.0 (ISO 32000-2 §7.11.4) voorzien elke file specification van een /AFRelationship-naam die vertelt hoe het ingesloten bestand zich verhoudt tot de inhoud waaraan het hangt: Source, Data, Alternative, Supplement, EncryptedPayload, FormData, Schema of Unspecified (Table 43). PDF/A-3 en ZUGFeRD- / Factur-X-facturen vertrouwen op deze vermelding om de machinaal leesbare XML-payload aan te merken

De eigenschap leest de vermelding via de native export FPDFAttachment_GetAFRelationship en geeft het ruwe naamtoken terug als Unicode-tekenreeks. Een lege tekenreeks krijg je wanneer de file specification geen /AFRelationship-vermelding heeft, wanneer de vermelding geen PDF-name is of wanneer de geladen pdfium.dll van vóór die export dateert (zie AttachmentRelationshipFeaturesAvailable)

De eigenschap is read-only. Om bestanden mét een relationship toe te voegen, gebruik je de Pascal-schrijfkant in FPdfAssocFiles, die dezelfde naamtokens wegschrijft

Parameters

Index Integer. Bijlagensleuf op basis van 0. Moet voldoen aan 0 <= Index < AttachmentCount; andere waarden leveren een EPdfError op (Incorrect attachment index)

Remarks

Alleen bijlagen die in de naamboom /EmbeddedFiles zijn geregistreerd hebben een index; een associated file die uitsluitend vanuit een /AF-array wordt gereferreerd, is via deze eigenschap niet bereikbaar (zie AttachmentCount)
De naam komt exact terug zoals hij in het bestand staat; vergelijk case-sensitive met de tokens uit ISO 32000-2
ReadAttachmentMetadata pakt dezelfde waarde voor alle bijlagen in één native pass mee in het veld Relationship van TPdfAttachmentMetadata, en TryGetAnnotationFileAttachment vult het bijbehorende veld voor file-attachment-annotaties
Een leeg resultaat maakt geen onderscheid tussen "geen vermelding" en "export ontbreekt"; controleer AttachmentRelationshipFeaturesAvailable wanneer dat verschil telt

Example

var
  I: Integer;
begin
  Pdf1.LoadFromFile('invoice-facturx.pdf');
  for I := 0 to Pdf1.AttachmentCount - 1 do
    if Pdf1.AttachmentRelationship[I] = 'Alternative' then
      SaveInvoiceXml(Pdf1.AttachmentName[I], Pdf1.Attachment[I]);
end;

AttachmentRelationship eigenschap