SetAutoTagMode

タグ付き PDF

説明

通常の描画呼び出しが自身で保持する構造タグ付けを有効にします

構文

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

パラメータ

Modeビットマスク: 1 はテキストをタグ付けし、2 はページ装飾をアーティファクトとしてマークし、4 は画像を図としてタグ付けし、8 は描画されたテーブルをタグ付けし、15 は 4 つすべてを実行し、0 は無効にします

戻り値

Modeこの呼び出しの前に有効だったモード
0負のモードを指定した場合も返されます。この値は拒否され、モードは変更されません

備考

テキストのタグ付けが有効な場合、テキストは段落としてタグ付けされ、RegisterHeading の直後に描画されたテキストはそのレベルの見出しとしてタグ付けされます。ページ装飾のマーク付けが有効な場合、ランニングヘッダーとフッターはアーティファクトとしてマークされるため、リーダーは各ページで同じ行を読み上げずスキップします

図のタグ付けが有効な場合、描画された画像は RegisterFigure が残した説明を持つ図になります。または、RegisterDecoration によって意味を持たないと指定された場合は、レイアウトアーティファクト内に描画されます

テーブルのタグ付けが有効な場合、DrawTableRows はテーブル、その行、セルを構造ツリーに反映します。SetTableHeaderRowCount で指定した行はヘッダーセルになります

このモードを有効にすると、ドキュメントもタグ付きとしてマークされる。このマークが存在するまでリーダーは構造がないものとして扱うため、マークのないタグ付きドキュメントは構造をまったく持たないかのように読み取られる

BeginTag で開いたタグ内では、自動タグ付けは介入しません。呼び出し元が構造自体を記述している間は、そのタグ内に何もネストされません。また、構造要素を置くとファイルが無効になるアーティファクト内ではタグ付けせず、読み上げ時に空白として通知される空のテキストに対しても要素を開きません

このモードはドキュメントではなくライブラリインスタンスに属します

例

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

関連項目

GetAutoTagMode、RegisterHeading、BeginTag、BeginArtifact、RegisterFigure、RegisterDecoration、SetTableHeaderRowCount