VP SET VALUE

VP SET VALUE ( rangeObj : Object ; valueObj : Object )

引数	型		説明
rangeObj	オブジェクト	->	レンジオブジェクト
valueObj	オブジェクト	->	セルの値とフォーマットオプション

説明

VP SET VALUE コマンドは、指定されたセルレンジに値を割り当てます。

このコマンドを使用すると、汎用的なコードで rangeObj のレンジに様々な型の値とそのフォーマットを設定できます。それに対して VP SET TEXT VALUE や VP SET NUM VALUE などの他のコマンドは、設定する値の型が限定されています。

rangeObj には、値を割り当てたいセルのレンジ (たとえば VP Cell あるいは VP Column で作成されたレンジ) を渡します。 rangeObj 引数に複数のセルが含まれる場合、指定された値はそれぞれのセルに対して繰り返し割り当てられます。

valueObj 引数は、rangeObj のレンジに対して割り当てたい値とフォーマット のプロパティを格納しているオブジェクトです。 このオブジェクトには以下のプロパティを含めることができます:

プロパティ	型	説明
value	Integer, Real, Boolean, Text, Date, Null	rangeObj のレンジに対して割り当てる値 (時間型を除く)。 セルの中身を消去するためには Null を渡します。
time	実数	rangeObj のレンジに対して割り当てる時間 (秒単位)
format	テキスト	値や日時に対するパターン 値や日時に対するパターン パターンおよびフォーマット文字に関しての情報については、セルフォーマット の章を参照してください。

例題

// セルの値を False に設定します
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";False))
 
// セルの値を 2 に設定します
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";2))
 
// セルの値を $125,571.35 に設定します
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)"))
 
// セルの値を Hello World!
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";"Hello World!"))
 
// セルの値を現在の日付に設定します
VP SET VALUE(VP Cell("ViewProArea";4;2);New object("value";Current date))
 
// セルの値を現在の時間に設定します
VP SET VALUE(VP Cell("ViewProArea";5;2);New object("time";Current hour))
 
// セルの値を特定の日付と時間に設定します
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))
 
// セルの中身を消去します
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";Null))

参照

セルフォーマット
VP Get values
VP SET VALUE
VP SET BOOLEAN VALUE
VP SET DATE TIME VALUE
VP SET FIELD
VP SET FORMULA
VP SET NUM VALUE
VP SET TEXT VALUE
VP SET TIME VALUE