BeginTagExA
タグ付き PDF、アクセシビリティ
説明
末尾の A は ANSI(char)DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は BeginTagEx と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます
現在のページで、自然言語属性を明示したタグ付き PDF 構造要素を開きます。BeginTag と同じですが、Lang パラメーターが追加され、その値が構造要素の /Lang 属性に書き込まれます
ドキュメントの既定言語(SetPDFUAMode または SetDocumentLanguage で設定)と異なる言語のコンテンツに、この関数を使用します。ISO 14289-1 §7.2 では、ドキュメントの主要言語ではないすべてのテキストセグメントに /Lang 属性を設定する必要があります
タグは均衡していなければなりません。各 BeginTagEx 呼び出しの後には、一致する EndTag 呼び出しが必要です。タグはネストできます
構文
Delphi
Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;
DLL
int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);
パラメータ
| TagType | PDF 標準構造タイプ: P、H1–H6、Figure、Table、TR、TH、TD、L、LI、LBody、Span、Link、Note など(ISO 32000-1 §14.8.4 を参照) |
|---|---|
| AltText | 画像およびその他の非テキストコンテンツ用の代替テキスト(/Alt 属性)。不要な場合は空文字列を渡す |
| ActualText | 視覚的な形式が論理的な意味と異なるコンテンツの置換テキスト(/ActualText 属性)。不要な場合は空文字列を渡します |
| Lang | この要素内のコンテンツに対する BCP 47 言語タグ 例: en-US、fr-FR、zh-Hans ドキュメント言語を継承するには空の文字列を渡します 空でない場合、この要素とすべての子孫に対してドキュメントレベルの言語を上書きします |
戻り値
| 0 | 失敗(ドキュメントが開かれていません) |
|---|---|
| 1 | タグが正常に開かれました |
例
// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;