WP Table get rows

4D v17

WP Table get rows


WP Table get rows ( tableRef ; startRow {; numRows} ) -> 戻り値

引数	型	説明
tableRef	Object	テーブル参照オブジェクト
startRow	倍長整数	最初の行の位置
numRows	倍長整数	取得したい行数
戻り値	Object	選択された行を含む新しいテーブルレンジ

説明

WP Table get rows コマンドは、startRow と numRows 引数で指定した、tableRef 引数のテーブルの新しいセルレンジオブジェクトを返します。

startRow 引数は、返す最初のテーブルを指定し、任意のnumRows 引数は返す行数を指定します。numRows 引数が省略された場合、単一のstartRow 行だけが返されます。
startRow 引数とnumRows 引数の合計がtableRef 引数で参照するテーブルの行数を超える場合、あるいはstartRow 引数がtableRef 引数で参照するテーブルの行数を超える場合、返されたレンジには最後の行までが含まれます。

例題 1

テーブルの最初の2行に対して特定の背景色を設定し、3行目の境界線を変更したい場合を考えます:

 C_OBJECT($wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$rows;$rows2)

 $wpRange:=WP Create range(WParea;wk start text;wk end text)

 

 $wpTable:=WP Insert table($wpRange;wk append)

 $wpRow1:=WP Table append row($wpTable;"Paul";"Smith";25)

 $wpRow2:=WP Table append row($wpTable;"John";"Richmond";40)

 $wpRow3:=WP Table append row($wpTable;"Mary";"Trenton";18)

 $wpRow4:=WP Table append row($wpTable;"Christopher";"Lee";53)

 $wpRow5:=WP Table append row($wpTable;"Henry";"Cartier";42)

 

 $rows:=WP Table get rows($wpTable;1;2)

 WP SET ATTRIBUTES($rows;wk background color;0x00E0F0FF)

 $rows2:=WP Table get rows($wpTable;3)

 WP SET ATTRIBUTES($rows2;wk border style;wk solid)

 WP SET ATTRIBUTES($rows2;wk border width;4)

例題 2

10行目の行から最後の行までのレンジを取得したい場合を考えます:

WP Table get rows(tableRef;10;MAXLONG)

参照

WP Insert table
WP Table append row
WP Table get cells
WP Table get columns