SetStructElemHeadersA

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

説明

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

タグスタックで現在開いている構造要素に /Headers 属性 (Table 属性所有者) を設定します。この属性は、現在のテーブルデータセルまたはヘッダーセルを、要素 ID で識別される 1 つ以上のテーブルヘッダーセルに関連付けます。位置だけでは推定できない複雑なテーブル構造の記述に使用します。BeginTag または BeginTagEx の後、EndTag の前に呼び出します

構文

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

パラメータ

Headers	現在の TD または TH セルの列ヘッダーまたは行ヘッダーである TH セルの要素 ID を、コンマ区切りで指定した一覧です。各 ID は、同じ文書内で以前に SetStructElemID を介して TH 要素に割り当てた ElemID と一致しなければなりません。コンマの前後の空白は無視されます。例: `TH-ProductName,TH-Price`

戻り値

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

備考

この関数は AddTagAttribute を、Owner=Table、Name=Headers、Value に同じカンマ区切り ID リストを指定して呼び出すことと同等である。この属性は PDF テキスト文字列の /Headers 配列として、構造要素の /A 属性辞書に書き込まれる

/Headers 属性は ISO 32000-1 §14.8.5.7.2（表属性の所有者）で定義されている。列見出しがデータセルの直上にある単純な表では、/Scope 属性を SetStructElemScope で設定すれば通常は十分である。結合セルまたは複数レベルの見出しを持つ不規則な表には /Headers を使用する

PDF/UA-1 (ISO 14289-1 §7.10) では、読み上げ順だけでは関連付けを判別できないテーブルにおいて、すべての TD セルをそのヘッダーセルへ明示的に関連付ける必要があります

例

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

SetStructElemHeadersA

説明

構文

Delphi

DLL

パラメータ

戻り値

備考

例

関連項目