WP Table get columns

4D v17


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

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

説明

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

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

例題 1

テーブルの、最後の2列の属性を変更したい場合を考えます:

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

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

 

 $cols:=WP Table get columns($wpTable;2;2)

 WP SET ATTRIBUTES($cols;wk background color;0x00E0E0E0;wk text color;"red";wk height;"36pt";wk text align;wk center)

結果:

例題 2

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

WP Table get columns(tableRef;10;MAXLONG)

参照

WP Table get cells
WP Table get rows