SetStructElemScopeA

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

説明

末尾の A は ANSI（char）DLL エントリポイントを示し、ActiveX/COM の表面では Unicode 形式のみ公開される。動作は SetStructElemScope と同一で、文字列引数は現在の SetAnsiMode コードページを使って解釈される

タグスタックで現在開いている構造要素に /Scope 属性（Table 属性所有者）を設定します。スコープは TH（表見出し）セルが列、行、またはその両方に適用されるかを識別します。これは見出しセルを持つ表で PDF/UA-1 により必要です。AddTagAttribute を Owner=Table、Name=Scope、値にスコープ名を指定して呼び出すことと同等です

構文

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

パラメータ

Scopeヘッダーセルのスコープ。次の値のいずれかを大文字と小文字を区別して指定します:

Column — ヘッダーは列内のすべてのセルに適用
Row — ヘッダーは行内のすべてのセルに適用
Both — ヘッダーは列と行の両方に適用

戻り値

成功時は 1 を返します。文書が開かれていない場合、またはタグスタックで現在開かれているタグがない場合は 0 を返します

備考

この関数は BeginTag（タグ型 TH）の後、EndTag の前に呼び出します。/Scope 属性は ISO 32000-1 §14.8.5.7.2（Table 属性所有者）で定義されます

PDF/UA-1（ISO 14289-1 §7.10）では、テーブルヘッダーセルがデータセルと明確に関連付けられている必要があります。テーブルレイアウトで可能な場合は、/Scope 属性を指定する方法が推奨されます

例

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

関連項目

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode