AddRoleMapA

タグ付き PDF、アクセシビリティ

説明

末尾の A は ANSI（char）DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は AddRoleMap と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます

ドキュメントの RoleMap 辞書で、カスタム構造要素型名から標準 PDF 構造型へのマッピングを登録します

タグ付き PDF コンテンツが非標準タグ名（例: 企業固有またはアプリ固有の要素型）を使用する場合、PDF 仕様ではその名前を構造ツリールートの /RoleMap エントリ内で標準 PDF 構造型へマップする必要があります。ISO 14289-1 §7.1 は、非標準構造要素型を含むすべての PDF/UA-1 ドキュメントにこのマッピングを要求します

カスタム型ごとに AddRoleMap を 1 回、BeginTag または BeginTagEx をその型で呼び出す前に呼び出します。複数のマッピングを登録できます。同じカスタム型を複数回登録すると、最後のマッピングが優先されます

少なくとも 1 つのマッピングが登録されている場合、文書保存時に RoleMap が構造ツリールートへ書き込まれます

構文

Delphi

Function DLAddRoleMapA(InstanceID: Integer; CustomType, StandardType: PAnsiChar): Integer;

DLL

int DLAddRoleMapA(int InstanceID, const char * CustomType, const char * StandardType);

パラメータ

CustomType	BeginTag または BeginTagEx 呼び出しで使用するカスタム（非標準）構造要素タイプ名。例: `Headline`、`Caption`、`Callout`
StandardType	カスタム形式のマップ先となる標準 PDF 構造形式: `P`、`H1`–`H6`、`Figure`、`Table`、`Span`、`Link`、`Note` など（ISO 32000-1 §14.8.4 を参照）。マッピングが PDF/UA 準拠チェッカーを満たすには、認識された標準形式でなければなりません

戻り値

0	失敗（ドキュメントが開かれていません）
1	マッピングが正常に登録されました

例

// Document with custom element types mapped to standard PDF structure types
PDF.SetPDFUAMode('en-US');
PDF.AddRoleMap('Headline', 'H1');
PDF.AddRoleMap('Subheadline', 'H2');
PDF.AddRoleMap('Caption', 'P');

PDF.BeginTag('Headline', '', '');
PDF.PrintText(50, 750, 'Annual Report 2026');
PDF.EndTag;

PDF.BeginTag('Subheadline', '', '');
PDF.PrintText(50, 720, 'Financial Highlights');
PDF.EndTag;