SetTableHeaderRowCount

表

説明

表の先頭何行をヘッダーとするかを示します

構文

Delphi

Function TPDFlib.SetTableHeaderRowCount(TableID, HeaderRowCount: Integer): Integer;

パラメータ

TableIDCreateTable が返したテーブル
HeaderRowCount先頭から何行をヘッダーとするか。0 はヘッダーなしを意味する

戻り値

1件数が取得されました
0テーブルが不明であるか、件数が負数または最終行を超えていたため、変更はありません

備考

ヘッダー行は列スコープを持つヘッダーセルとして書き込まれます。これにより、リーダーは数値だけでなく、その値が属する見出しを読み上げられます

どの行が見出しかを知っているのは呼び出し元だけです。そのため、何も指定しないテーブルでは推測せず、すべてをデータセルとして書き込みます。誤って見出しとされた名前は、その下のすべての値に対して繰り返されるためです

この数は、テーブルタグ付きでテーブルを描画する場合(SetAutoTagMode を参照)と、DrawTaggedTableRows で使用されます。これはヘッダーを指定するだけで、各ページ上部での繰り返しは DrawTaggedTableRows で行う別のレイアウト判断です。SetTableCellTag を使用すると個別のセルに独自の型を指定でき、その指定が優先されます

例

PDF.SetAutoTagMode(AUTOTAG_DEFAULT);
Table := PDF.CreateTable(4, 3);
PDF.SetTableHeaderRowCount(Table, 1);   // the first row names the columns
PDF.DrawTableRows(Table, 50, 780, 240, 1, 0);

関連項目

GetTableHeaderRowCount、SetTableCellTag、DrawTaggedTableRows、SetAutoTagMode