SetStructElemRowSpan

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

説明

タグスタックで現在開いている構造要素に /RowSpan 属性 (Table attribute owner) を設定します 値は現在の表セルがまたがる行数を示します AddTagAttribute を Owner=Table、Name=RowSpan、整数値を文字列として呼び出すことと同等です

構文

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

パラメータ

RowSpan現在のテーブルセルがまたがる行数。正の整数である必要があります。値 1 はセルがちょうど 1 行を占めることを意味します（RowSpan が設定されていない場合の既定動作）。1 より大きい値は、セルが複数行にまたがることを示します

戻り値

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

備考

この関数は BeginTag の後（タグタイプ TH または TD）かつ EndTag の前に呼び出します。/RowSpan 属性は ISO 32000-1 §14.8.5.7.2（Table attribute owner, Table 337）で定義されています

行をまたぐセルは、ヘッダーセルまたはデータセルを複数行にわたって垂直方向に伸ばす必要があるテーブルで使用します。たとえば、複数のデータ行で共有する行ヘッダーです。/RowSpan 属性を指定すると、支援技術がテーブルの論理グリッドモデルを正しく構築できます

セルが複数列にもまたがる場合は、SetStructElemColSpan をこの関数と組み合わせて使用します

例

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

関連項目

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag