SetEmbeddedFileAFRelationshipA

PDF/UA & アクセシビリティ

説明

末尾の A は ANSI（char）DLL エントリポイントを示し、ActiveX/COM の表面では Unicode 形式のみ公開される。動作は SetEmbeddedFileAFRelationship と同一で、文字列引数は現在の SetAnsiMode コードページを使って解釈される

埋め込みファイルのファイル仕様辞書に AFRelationship キーを設定します アクセシブルな PDF ドキュメントに埋め込みファイルを含める場合、ISO 14289-1 (PDF/UA-1) §7.11 で必須です

構文

Delphi

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

DLL

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

パラメータ

Index埋め込みファイルの 0 から始まるインデックス。有効な範囲は 0 から EmbeddedFileCount - 1 までです
AFRelationship埋め込みファイルと文書の関係。次の大文字と小文字を区別する値のいずれかでなければなりません:

Source — 埋め込みファイルは文書の作成に使用したソースファイルです
Data — 埋め込みファイルは文書が使用するデータを含みます
Alternative — 埋め込みファイルは文書内容の代替表現です
Supplement — 埋め込みファイルは文書の補足です
Unspecified — 関係が指定されていません（SetPDFUAMode がアクティブな場合の既定）

戻り値

成功時は 1 を返します。インデックスが範囲外、AFRelationship 値が 5 つの有効値のいずれでもない、またはドキュメントが開いていない場合は 0 を返します

備考

SetPDFUAMode が有効な場合、PDF Library for Delphi はキーをまだ持たない埋め込みファイルごとに AFRelationship を自動的に Unspecified に設定します。保存前に SetEmbeddedFileAFRelationship を使用すると、この既定値をより具体的な関係値で上書きできます

埋め込みファイルを追加した後、ドキュメントを保存する前にこの関数を呼び出します

例

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

関連項目

SetPDFUAMode、SetPDFAMode、AddFileAttachment、AddEmbeddedFile、EmbedFile、SetEmbeddedFileStrProperty