WP Table get columns
WP Table get columns ( targetObj ) | ( tableRef ; startCol {; numCols} ) -> 戻り値
| 引数 | 型 | 説明 | |
|---|---|---|---|
| targetObj | オブジェクト | 🡒 | レンジまたは要素または4D Write Pro ドキュメント |
| tableRef | オブジェクト | 🡒 | テーブル参照オブジェクト |
| startCol | 倍長整数 | 🡒 | 最初のカラムの位置 |
| numCols | 倍長整数 | 🡒 | 取得するカラムの位置 |
| 戻り値 | オブジェクト | 🡐 | 選択されたカラムを含む新しいテーブルレンジ |
説明
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)