BeginMarkedContent
タグ付きPDF、アクセシビリティ
説明
現在のコンテンツストリームにBDC(プロパティリスト付きマーク付きコンテンツの開始)オペレーターを書き込むことで、マーク付きコンテンツ範囲を開きます。これは通常、(PDF/UAなどの)アクセシビリティ要件を満たす構造化(タグ付き)PDFを作成するために使用されますマーク付きコンテンツ範囲は正しくバランスしなければなりません。
BeginMarkedContentのすべての呼び出しは、対応するEndMarkedContentの呼び出しで閉じられる必要があります。マーク付きコンテンツ範囲はネストできます
構文
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;パラメータ
| TagType | 構造タグ名。たとえば/Span、/P、/Figureなど |
|---|---|
| AltText | アクセシビリティのための代替説明テキスト(プロパティリストの/Altキーに対応)。不要な場合は空の文字列を渡します |
| ActualText | スクリーンリーダー向けにグリフ表現を置き換える実際のテキスト(/ActualTextキーに対応)。不要な場合は空の文字列を渡します |
| Lang | マーク付きコンテンツの自然言語コード(たとえばen-US、/Langキーに対応)。不要な場合は空の文字列を渡します |
| Expansion | 略語または頭字語の展開テキスト(/Eキーに対応)。不要な場合は空の文字列を渡します |
戻り値
| 0 | ドキュメントが開かれていない、またはマーク付きコンテンツの書き込みに失敗した |
|---|---|
| 1 | マーク付きコンテンツ範囲が正常に開かれた |
備考
準拠したタグ付きPDF/UAファイルを構築するには、論理構造タグがすべての可視テキストとグラフィックスを囲むようにしてください。この関数はBeginTagと比べてきめ細かいプロパティマッピングを提供します
例
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;