WP Table get cells

4D v17

WP Table get cells


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

引数	型	説明
tableRef	Object	テーブル参照オブジェクト
startCol	倍長整数	先頭セルの位置 (カラム)
startRow	倍長整数	先頭セルの位置 (行)
numCols	倍長整数	取得するカラムの数
numRows	倍長整数	取得する行の数
戻り値	Object	指定セルを含む新規レンジ

説明

WP Table get cells コマンドは tableRef で指定したテーブルより、startCol、 startRow、 numCols、および numRows で定義したセル範囲を新規レンジオブジェクトとして返します。

startCol および startRow パラメーターは取得するセル範囲の先頭セル (左上)の位置を定義します。任意のnumCols および numRows パラメーターを渡すことで、取得するセル範囲のカラム数および行数を指定することもできます。numRows が省略された場合は一行だけ取得します。numCols と numRows パラメーターを両方省略した場合には、一つのセルだけを取得します。

startCol と numCols、または startRow と numRows の和が tableRef のカラム数、または行数を超過する場合や、先頭セルを指定するstartCol およびstartRow の値が tableRef のカラム数および行数を超えている場合には、返されたレンジには最後のカラム/行までが含まれます。

例題 1

特定のセル範囲の属性を変更します:

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

 $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)

 

 $cells:=WP Table get cells($wpTable;2;2;2;2)

 WP SET ATTRIBUTES($cells;wk background color;0x00E0E0E0)

 WP SET ATTRIBUTES($cells;wk text color;"blue")

 WP SET ATTRIBUTES($cells;wk border color;0x00E000E0)

 WP SET ATTRIBUTES($cells;wk text align;wk center)

結果:

例題 2

"5x7"のセルから行の最後までのセルのレンジを取得する場合を考えます:

$cellRange:=WP Table get cells(tableRef;5;7;MAXLONG;1)

"5x7"のセルからカラムの最後までのセルのレンジを取得する場合を考えます:

$cellRange:=WP Table get cells(tableRef;5;7;1;MAXLONG)

"5x7"のセルからテーブルの最後までのセルのレンジを取得する場合を考えます:

$cellRange:=WP Table get cells(tableRef;5;7;MAXLONG;MAXLONG)

参照

WP Table get columns
WP Table get rows