VP SET VALUE

4D v19

VP SET VALUE


VP SET VALUE ( rangeObj ; valueObj )

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

説明

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

このコマンドを使用すると、一般的なコードを使用して、rangeObj 引数で指定したレンジに対して値とその値の型を設定できます。それに対してVP SET TEXT VALUE や VP SET NUM VALUE などの他のコマンドは、指定する値の型が限定されています。

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

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

プロパティ	型	詳細
value	倍長整数、実数、ブール、テキスト、日付、Null	rangeObj 引数のレンジに対して割り当てたい値(ただし時間型を除く)。セルの中身を消去するためにはNull を渡します。
time	実数	rangeObj 引数のレンジに対して割り当てたい時間(秒単位)。
format	テキスト	value/time プロパティに対して使用するパターン。パターンとフォーマット用文字の情報については、4D View Pro セルフォーマットの章を参照してください。

例題

  // セルの値を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 time))

 

  // セルの値を特定の日付と時間に設定

 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))

参照

4D View Pro セルフォーマット
 VP Get value
VP SET BOOLEAN VALUE
VP SET DATE TIME VALUE
VP SET DATE VALUE
VP SET FIELD
VP SET FORMULA
VP SET NUM VALUE
VP SET TEXT VALUE
VP SET TIME VALUE
VP SET VALUES