BeginTagA

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

説明

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

現在のページでタグ付き PDF 構造要素を開きます。コンテンツストリームに BDC（辞書付きマークドコンテンツの開始）演算子を書き込み、ドキュメントの論理構造ツリーに要素を登録します。構造ツリーは保存時に自動的に完成します

タグは均衡していなければならない。BeginTag 呼び出しの後には、対応する EndTag 呼び出しが必要である。タグは入れ子にできる

構文

Delphi

Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;

DLL

int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);

パラメータ

TagTypePDF 標準構造タイプ: P、H1–H6、Figure、Table、TR、TH、TD、L、LI、LBody、Span、Link、Note など（ISO 32000-1 §14.8.4 を参照）
AltText画像およびその他の非テキストコンテンツの代替テキスト（PDF の /Alt 属性に対応）。不要な場合は空文字列を渡します
ActualText視覚表現と論理的意味が異なるコンテンツの置換テキスト（PDF の /ActualText 属性に対応）。不要な場合は空文字列を渡します

戻り値

0失敗（ドキュメントが開かれていません）
1タグが正常に開かれました

例

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

備考

スクリーンリーダーで読み上げる必要がない装飾コンテンツ (ページヘッダー、フッター、背景要素) には、BeginArtifact/EndArtifact を使用します

文書は書き込みモード（新規作成または変更用にオープン）である必要があります。PDF/UA-1 要件を満たすにはタグ付け前に SetPDFUAMode を呼び出します