VP SET VALUES

4D v19

VP SET VALUES


VP SET VALUES ( rangeObj ; valuesCol )

引数	型	説明
rangeObj	オブジェクト	セルレンジオブジェクト
valuesCol	コレクション	値のコレクション

説明

VP SET VALUES コマンドは、指定されたセルレンジから値のコレクションを割り当てていきます。

rangeObj 引数には、値を指定したいセルのレンジ(VP Cell で作成されたもの)を渡します。rangeObj 引数で定義されたセルは、開始ポイントを決定します。

注:

rangeObj 引数がセルレンジではない場合、レンジの最初のセルのみが使用されます。
rangeObj 引数に複数のレンジが含まれる場合、最初のレンジの最初のセルのみが使用されます。

valuesCol 引数は、2次元構造のコレクションとなっています:

第一レベルのコレクションは値のサブコレクションを格納しています。それぞれのサブコレクションは行を定義しています。行をスキップするためには空のコレクションを渡します。
それぞれのサブコレクションは行に対してセル値を定義します。値には倍長整数、実数、ブール値、テキスト、日付、Null、あるいはオブジェクトを指定することができます。値がオブジェクトの場合、以下のプロパティを持つことができます:
プロパティ 型詳細
value 倍長整数、実数、ブール値、テキスト、日付、Null セルの値(ただし時間を除く)
time 実数時間値(秒数)

例題

以下のコードを実行すると:

 $param:=New collection

 $param.push(New collection(1;2;3;False)) // 一行目、値は4つ

 $param.push(New collection) // 二行目、空行

 $param.push(New collection(4;5;Null;"hello";"world")) // 三行目、値は5つ

 $param.push(New collection(6;7;8;9)) // 四行目、値は4つ

 $param.push(New collection(Null;New object("value";Current date;"time";42))) // 五行目、値は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