SetStructElemColSpan

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

説明

タグスタックで現在開いている構造要素に /ColSpan 属性（Table 属性所有者）を設定します。この値は現在のテーブルセルがまたがる列数を示します。AddTagAttribute を Owner=Table、Name=ColSpan、および文字列としての整数値で呼び出すことと同等です

構文

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

パラメータ

ColSpan現在のテーブルセルがまたがる列数です。正の整数でなければなりません。値 1 はセルが正確に 1 列を占めることを意味します (ColSpan が未設定の場合のデフォルト動作)。1 より大きい値は複数列にまたがるヘッダーセルまたはデータセルを示します

戻り値

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

備考

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

複雑な表では、たとえば 2 つのデータ列にまたがる列ヘッダーのように、セルの結合がよく使用されます。/ColSpan 属性を指定すると、支援技術が表グリッド全体でセル位置を正しく計算し、ヘッダーをデータセルに関連付けられます

セルが複数行にもまたがる場合は、この関数と SetStructElemRowSpan を組み合わせます

例

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

関連項目

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag