4D Doc Center : LISTBOX GET CELL POSITION

Home

4D v14.3

LISTBOX GET CELL POSITION


LISTBOX GET CELL POSITION ( {* ;} Objekt ; Spalte ; Zeile {; SpaltenVar} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern ist Objekt ein Objektname (string), Ohne Stern ist Objekt eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
Spalte	Lange Ganzzahl	Spaltennummer
Zeile	Lange Ganzzahl	Zeilennummer
SpaltenVar	Zeiger	Zeiger auf Spaltenvariable

Beschreibung

Der Befehl LISTBOX GET CELL POSITION gibt die Nummern von Spalte und Zeile zurück, die der Position des letzten Mausklicks bzw.der letzten Auswahl über die Tastatur in der Listbox entsprechen, angegeben durch * und Objekt. Dieser Befehl gibt die Koordinaten eines Klick oder einer Auswahlaktion auch dann zurück, wenn die Listbox weder Auswählen noch Eingeben von Daten erlaubt.

Hinweis: Die in Zeile zurückgegebene Nummer berücksichtigt nicht den Status ein-/ausgeblendet der Listbox-Zeilen.

Übergeben Sie den optionalen Parameter *, ist Objekt ein Objektname (String). Übergeben Sie diesen Parameter nicht, ist Objekt eine Variable.
Der optionale Parameter SpaltenVar gibt einen Zeiger auf die Variable zurück (z.B. Array), die der Spalte zugeordnet ist.

LISTBOX GET CELL POSITION lässt sich nur im Rahmen einer Listbox aufrufen, die eins der folgenden Formularereignisse erzeugt:

On Clicked und On Double Clicked
On Before Keystroke und On After Keystroke
On After Edit
On Getting Focus und On Losing Focus
On Data Change
On Selection Change
On Before Data Entry

Wird der Befehl in einem anderen Kontext aufgerufen, gibt er in Spalte und Zeile den Wert 0 zurück.
Er berücksichtigt alle Änderungen an der Auswahl bzw. Abwahl, sei es durch Mausklick oder über Tastatur, über die Befehle EDIT ITEM, der das Ereignis On getting Focus erzeugen kann.

Wurde die Auswahl über Pfeiltasten der Tastatur verändert, gibt Spalte den Wert 0 (Null) zurück. In diesem Fall gibt der Parameter SpaltenVar - sofern übergeben - den Wert Nil zurück.
Die durch den Befehl zurückgegebenen Werte werden nicht aktualisiert bei rechtem Mausklick in einen Spaltentitel innerhalb der Listbox.