SetEmbeddedFileAFRelationship

PDF/UA ir prieinamumas

Aprašymas

Nustato AFRelationship raktą failo specifikacijos žodyne įterptam failui. Reikalaujama pagal ISO 14289-1 (PDF/UA-1) §7.11, kai įterpti failai įtraukiami į prieinamą PDF dokumentą.

Sintaksė

Delphi

Function TPDFlib.SetEmbeddedFileAFRelationship(Index: Integer; Const AFRelationship: WideString): Integer;

ActiveX

Function PDFlib::SetEmbeddedFileAFRelationship(Index As Long, AFRelationship As String) As Long

DLL

int DLSetEmbeddedFileAFRelationship(int InstanceID, int Index, const wchar_t * AFRelationship);

Parametrai

Index	Įterpto failo indeksas, skaičiuojamas nuo nulio. Galiojantis intervalas: 0 iki EmbeddedFileCount - 1
AFRelationship	Įterptojo failo ryšys su dokumentu. Turi būti viena iš šių raidžių dydį skiriančių reikšmių: Source — įterptasis failas yra šaltinio failas, naudotas dokumentui sukurti Data — įterptasis failas turi dokumento naudojamų duomenų Alternative — įterptasis failas yra alternatyvioji dokumento turinio atvaizduotė Supplement — įterptasis failas papildo dokumentą Unspecified — ryšys nenurodytas (numatytasis, kai aktyvus SetPDFUAMode)

Index

Įterpto failo indeksas, skaičiuojamas nuo nulio. Galiojantis intervalas: 0 iki EmbeddedFileCount - 1

AFRelationship

Įterptojo failo ryšys su dokumentu. Turi būti viena iš šių raidžių dydį skiriančių reikšmių:

Source — įterptasis failas yra šaltinio failas, naudotas dokumentui sukurti
Data — įterptasis failas turi dokumento naudojamų duomenų
Alternative — įterptasis failas yra alternatyvioji dokumento turinio atvaizduotė
Supplement — įterptasis failas papildo dokumentą
Unspecified — ryšys nenurodytas (numatytasis, kai aktyvus SetPDFUAMode)

Grąžinama reikšmė

Grąžina 1 sėkmės atveju. Grąžina 0, jei indeksas už leistinų ribų, AFRelationship reikšmė nėra viena iš penkių galiojančiųjų arba neatvertas joks dokumentas

Pastabos

Kai SetPDFUAMode aktyvi, PDF Library for Delphi automatiškai nustato AFRelationship į Unspecified bet kuriam įterptamajam failui, kuris dar neturi rakto. Naudokite SetEmbeddedFileAFRelationship prieš išsaugodami, kad šį numatytąjį pakeistumėte konkretesne ryšio reikšme

Iškvieskite šią funkciją pridėję įterptąjį failą ir dar prieš išsaugodami dokumentą

Pavyzdys

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

Taip pat žiūrėkite

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty