SetEmbeddedFileAFRelationshipA

PDF/UA & Akadálymentesség

Leírás

A záró A a DLL ANSI-belépési pontját (char) jelöli; az ActiveX/COM felület csak a Unicode formát teszi elérhetővé. A működés megegyezik ezzel: SetEmbeddedFileAFRelationship, és a sztringargumentumok a jelenlegi SetAnsiMode kódlap alapján értelmeződnek

Beállítja az AFRelationship kulcsot egy beágyazott fájl fájlspecifikációs szótárán. Az ISO 14289-1 (PDF/UA-1) §7.11 szerint kötelező, ha beágyazott fájlok szerepelnek egy akadálymentes PDF-dokumentumban

Szintaxis

Delphi

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

DLL

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

Paraméterek

Index	A beágyazott fájl nullától induló indexe. Érvényes tartomány: 0 – EmbeddedFileCount - 1
AFRelationship	A beágyazott fájl viszonya a dokumentumhoz. A következő kis- és nagybetűérzékeny értékek egyike legyen: Source — forrásfájl Data — a dokumentum adatait tartalmazza Alternative — alternatív megjelenítés Supplement — dokumentumkiegészítés Unspecified — a viszony nincs megadva (alapértelmezett, ha a SetPDFUAMode aktív)

Visszatérési érték

Siker esetén 1-et ad vissza. 0-t ad vissza, ha az index tartományon kívül esik, az AFRelationship értéke nem az öt érvényes érték egyike, vagy nincs megnyitott dokumentum

Megjegyzések

Amikor a SetPDFUAMode aktív, a PDF Library for Delphi automatikusan a AFRelationship értéket Unspecified értékre állítja minden olyan beágyazott fájlnál, amely még nem rendelkezik ezzel a kulccsal. Mentés előtt a SetEmbeddedFileAFRelationship használatával ezt az alapértéket pontosabb kapcsolatértékkel írhatja felül

Az embedded fájl hozzáadása után és a dokumentum mentése előtt hívja meg ezt a függvényt

Példa

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

Lásd még

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty