VP Get selection

Home

4D v19

VP Get selection


VP Get selection ( vpAreaName {; sheet} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
vpAreaName	Text	Name des Formularobjekts im 4D View Pro Bereich
sheet	Lange Ganzzahl	Arbeitsblatt Index (ohne Angabe aktuelles Arbeitsblatt)
Funktionsergebnis	Objekt	Range Objekt mit Zellen

Beschreibung

Der Befehl VP Get selection gibt ein neues Range Objekt zurück, das auf die aktuell ausgewählten Zellen verweist.

In vpAreaName übergeben Sie den Namen des 4D View Pro Bereichs. Übergeben Sie einen Namen, der nicht existiert, wird ein Fehler zurückgegeben.

Im optionalen Parameter sheet können Sie ein spezifisches Arbeitsblatt angeben, in dem der Range definiert wird (die Zählung beginnt bei 0). Ohne Angabe wird standardmäßig das aktuelle Arbeitsblatt verwendet. Mit folgender Konstante können Sie explizit das aktuelle Arbeitsblatt auswählen:

Konstante	Wert	Kommentar
vk current sheet	-1	Bestimmt das aktuelle Arbeitsblatt des 4D View Pro Bereichs (Standard)

Beispiel

Folgender Code:

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

 

  //gibt ein Range Objekt zurück mit:  

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

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

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

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

findet die Koordinaten aller Zellen in der aktuellen Auswahl:

Siehe auch

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