SetEmbeddedFileAFRelationship

PDF/UA, Dostopnost

Opis

V slovarju specifikacije datoteke vgrajene datoteke nastavi ključ AFRelationship. Zahtevan s strani ISO 14289-1 (PDF/UA-1) §7.11, kadar so v dostopnem dokumentu PDF vključene vgrajene datoteke

Sintaksa

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

Parametri

Index	Indeks vgrajene datoteke, šteto od nič. Veljaven razpon: 0 do EmbeddedFileCount - 1
AFRelationship	razmerje vgrajene datoteke do dokumenta. Mora biti ena od naslednjih vrednosti (ločevanje velikih in malih črk): Source — vgrajena datoteka je izvirna datoteka, uporabljena za ustvarjanje dokumenta Data — vgrajena datoteka vsebuje podatke, ki jih uporablja dokument Alternative — vgrajena datoteka je nadomestna predstavitev vsebine dokumenta Supplement — vgrajena datoteka je dopolnitev dokumenta Unspecified — razmerje ni določeno (privzeto, kadar je aktiven SetPDFUAMode)

Index

Indeks vgrajene datoteke, šteto od nič. Veljaven razpon: 0 do EmbeddedFileCount - 1

AFRelationship

razmerje vgrajene datoteke do dokumenta. Mora biti ena od naslednjih vrednosti (ločevanje velikih in malih črk):

Source — vgrajena datoteka je izvirna datoteka, uporabljena za ustvarjanje dokumenta
Data — vgrajena datoteka vsebuje podatke, ki jih uporablja dokument
Alternative — vgrajena datoteka je nadomestna predstavitev vsebine dokumenta
Supplement — vgrajena datoteka je dopolnitev dokumenta
Unspecified — razmerje ni določeno (privzeto, kadar je aktiven SetPDFUAMode)

Vrnjena vrednost

Ob uspehu vrne 1. Vrne 0, kadar je indeks izven razpona, vrednost AFRelationship ni ena od petih veljavnih vrednosti ali ni odprt dokument

Opombe

Kadar je SetPDFUAMode aktiven, PDF Library for Delphi samodejno nastavi AFRelationship na Unspecified za vsako vgrajeno datoteko, ki ključa še nima. To privzeto vrednost lahko z bolj konkretno vrednostjo razmerja preglasi s SetEmbeddedFileAFRelationship pred shranjevanjem

To funkcijo pokličite po dodajanju vgrajene datoteke in pred shranjevanjem dokumenta

Primer

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

Glejte tudi

SetPDFUAMode, SetPDFAMode, AddFileAttachment, AddEmbeddedFile, EmbedFile, SetEmbeddedFileStrProperty