WP Table get columns
WP Table get columns ( targetObj ) | ( tableRef ; startCol {; numCols} ) -> 戻り値
| 引数 | 型 | 説明 | |
|---|---|---|---|
| targetObj | Object | → | レンジまたは要素または4D Write Pro ドキュメント |
| tableRef | Object | → | テーブル参照オブジェクト |
| startCol | Integer | → | 最初のカラムの位置 |
| numCols | Integer | → | 取得するカラムの位置 |
| 戻り値 | Object | ← | 選択されたカラムを含む新しいテーブルレンジ |
説明
WP Table get columns コマンドは、targetObj または(startCol および numCols 引数で定義された)tableRef で指定した表から、カラムのセレクションを格納した新しいレンジオブジェクトを返します。
以下のいづれかを渡します:
- targetObj 引数の場合、渡せるもの:
- レンジ
- 要素(行/段落/本文/ヘッダー/フッター/インラインピクチャー/セクション/サブセクション)
- 4D Write Pro ドキュメント
targetObj 引数が、表、またはカラムのセレクションを取得可能なテキストレンジと交差しない場合、コマンドはNull を返します。
または
- tableRef - カラムのセレクションを取得した表の参照
- startCol - 返す表の最初のカラムを指定
- (オプション) numCols - 返すカラムの数を指定。numCols 引数が省略された場合、startCol 引数で指定したカラム1つだけが返されます。
startCol 引数と numCols 引数を足した数がtableRef 引数で指定した表にあるカラムの数より多い場合、またはstartCol 引数そのものがtableRef 引数で指定した表にあるカラムの数より多い場合、返されるレンジには取得可能なカラム全てが格納されます。
例題 1
テーブルの、最後の2列の属性を変更したい場合を考えます:
var $wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$cols : Object
$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)
例題 3
ユーザーが選択したカラムを取得したい場合を考えます:
var $userSelection;$columns : Object
$userSelection:=WP Selection range(myWPArea)
$columns:=WP Table get columns($userSelection)