SetEmbeddedFileAFRelationshipA

PDF/UA & tilgjengelighet

Beskrivelse

Den avsluttende A angir ANSI-inngangspunktet (char) i DLL-en; ActiveX/COM-flaten eksponerer kun Unicode-formen. Oppførselen er identisk med SetEmbeddedFileAFRelationship og strengargumenter tolkes ut fra gjeldende kodetabell i SetAnsiMode

Setter AFRelationship-nøkkelen i filspesifikasjonsordboken for en innebygd fil. Kreves av ISO 14289-1 (PDF/UA-1) §7.11 når innebygde filer inngår i et tilgjengelig PDF-dokument

Syntaks

Delphi

Function DLSetEmbeddedFileAFRelationshipA(InstanceID, Index: Integer; AFRelationship: PAnsiChar): Integer;

DLL

int DLSetEmbeddedFileAFRelationshipA(int InstanceID, int Index, const char * AFRelationship);

Parametere

Index	Nullbasert indeks til den innebygde filen. Gyldig område: 0 til EmbeddedFileCount - 1
AFRelationship	Forholdet mellom den innebygde filen og dokumentet. Må være én av følgende verdier (skiller på store/små bokstaver): Source — den innebygde filen er kildefilen som ble brukt til å lage dokumentet Data — den innebygde filen inneholder data som brukes av dokumentet Alternative — den innebygde filen er en alternativ representasjon av dokumentinnholdet Supplement — den innebygde filen er et supplement til dokumentet Unspecified — forholdet er ikke spesifisert (standard når SetPDFUAMode er aktiv)

Index

Nullbasert indeks til den innebygde filen. Gyldig område: 0 til EmbeddedFileCount - 1

AFRelationship

Forholdet mellom den innebygde filen og dokumentet. Må være én av følgende verdier (skiller på store/små bokstaver):

Source — den innebygde filen er kildefilen som ble brukt til å lage dokumentet
Data — den innebygde filen inneholder data som brukes av dokumentet
Alternative — den innebygde filen er en alternativ representasjon av dokumentinnholdet
Supplement — den innebygde filen er et supplement til dokumentet
Unspecified — forholdet er ikke spesifisert (standard når SetPDFUAMode er aktiv)

Returverdi

Returnerer 1 ved suksess. Returnerer 0 hvis indeksen er utenfor området, AFRelationship-verdien ikke er en av de fem gyldige verdiene, eller ingen dokument er åpent

Merknader

Når SetPDFUAMode er aktiv, setter PDF Library for Delphi automatisk AFRelationship til Unspecified for enhver innebygd fil som ikke allerede har nøkkelen. Bruk SetEmbeddedFileAFRelationship før lagring for å overstyre denne standarden med en mer spesifikk relasjonsverdi

Kall denne funksjonen etter at den innebygde filen er lagt til, og før dokumentet lagres

Eksempel

// PDF/A-3 archive that embeds an XLSX as the document's source data
var
  FileID: Integer;
begin
  PDF.SetPDFAMode(5);              // PDF/A-3b — allows arbitrary embedded files
  PDF.NewDocument;
  PDF.AddStandardFont('Helvetica');
  PDF.AddPage;
  PDF.PrintText(50, 750, 'Quarterly Sales Report');

  FileID := PDF.AddEmbeddedFile(
    'sales-Q1.xlsx',
    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
  PDF.AddFileAttachment('Source spreadsheet', FileID);

  // Mark the relationship: the spreadsheet is the source of the report
  PDF.SetEmbeddedFileAFRelationship(1, 'Source');

  PDF.SaveToFile('report-PDFA3b.pdf');
end;

Se også

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty