VP SET VALUES
VP SET VALUES ( rangeObj : Object ; valuesCol : Collection )
| 引数 | 型 | 説明 | ||
|---|---|---|---|---|
| rangeObj | Object | -> | レンジオブジェクト | |
| valuesCol | Collection | -> | 値のコレクション |
説明
VP SET VALUES コマンドは、指定のセルレンジから 開始して値のコレクションを割り当てていきます。
rangeObj には、値を割り当てたいセルのレンジ (たとえば VP Cell あるいは VP Column で作成されたレンジ) を渡します。 rangeObj 引数で定義されたセルは、開始ポイントを決定します。
- rangeObj がセルレンジではない場合、レンジの最初のセルが使用されます。
- rangeObj のレンジが複数レンジを指定している場合、最初のレンジの先頭セルのみが使用されます。
valuesCol 引数は 2次元構造のコレクションです:
- 第1レベルのコレクションは、値のサブコレクションを格納しています。 それぞれのサブコレクションは行を定義します。 行をスキップするには空のコレクションを渡します。
- それぞれのサブコレクションは行におけるセルの値を定義します。 値は整数、実数、ブール、テキスト、日付、Null、オブジェクトのいずれかです。 値がオブジェクトの場合、以下のプロパティを持つことができます:
| プロパティ | 型 | 説明 |
|---|---|---|
| value | Integer, Real, Boolean, Text, Date, Null | セルの値 (時間部分を除く) |
| time | Real | 時間値 (秒単位) |
例題
$param:=New collection
$param.push(New collection(1;2;3;False)) // 1行目用に 4つの値を設定します
$param.push(New collection) // 2行目は空行です
$param.push(New collection(4;5;Null;"hello";"world")) // 3行目用に 5つの値を設定します
$param.push(New collection(6;7;8;9)) // 4行目用に 4つの値を設定します
$param.push(New collection(Null;New object("value";Current date;"time";42))) // 5行目用に 1つの値を設定します
VP SET VALUES(VP Cell("ViewProArea";2;1);$param)
参照
VP Get formulas
VP Get value
VP Get Values
VP SET FORMULAS
VP SET VALUE