VP Get selection

4D v19

VP Get selection


VP Get selection ( vpAreaName {; sheet} ) -> 戻り値

引数	型	説明
vpAreaName	テキスト	4D View Pro エリアフォームオブジェクト名
sheet	倍長整数	シートインデックス(省略時はカレントシート)
戻り値	オブジェクト	セルのレンジオブジェクト

説明

VP Get selection コマンドは、現在選択されいているセルを参照する新しいレンジオブジェクトを返します。

vpAreaName 引数には、4D View Pro エリアの名前を渡します。存在しない名前を渡した場合、エラーが返されます。

sheet 任意の引数を使用すると、レンジが定義される特定のスプレッドシートを指定することができます(0 番から数え始めます)。省略時、カレントのスプレッドシートがデフォルトで使用されます。以下の定数を使用することで、カレントのスプレッドシートを明示的に選択することができます:

定数	値	コメント
vk current sheet	-1	4D View Pro エリアのカレントシートを指定します。(デフォルト)

例題

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

 $currentSelection:=VP Get selection("myVPArea")

 

  //以下のようなものを格納したレンジオブジェクトが返されます

  //$currentSelection.ranges[0].column=5

  //$currentSelection.ranges[0].columnCount=2

  //$currentSelection.ranges[0].row=8

  //$currentSelection.ranges[0].rowCount=6

カレントのセレクションに含まれている全てのセルの座標が取得できます:

参照

VP ADD SELECTION
VP Get active cell
VP RESET SELECTION
VP SET ACTIVE CELL
VP SET SELECTION
VP SHOW CELL