LISTBOX GET CELL POSITION

Home

4D v20 R7


LISTBOX GET CELL POSITION ( {* ;} Objekt {; X ; Y }; 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 )
X	Zahl	Horizontale Koordinate der Maus
Y	Zahl	Vertikale Koordinate der Maus
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, der letzten Auswahl über die Tastatur oder der horizontalen und vertikalen Koordinaten der Maus in der Listbox entsprechen, angegeben durch * und Objekt.

Mit dem optionalen Parameter * ist Objekt ein Objektname (String), ohne diesen Parameter ist Objekt eine Variable.

Sind die Parameter X und Y übergeben, gibt der Befehl die Spalten- und Zeilennummer der Mauskoordinaten zurück, sonst die Spalten- und Zeilennummer eines Klicks oder einer Auswahl. Er gibt auch dann gültige Werte zurück, wenn keine Dateneingabe in die Listbox erlaubt ist.

Hinweise:

Die in Zeile zurückgegebene Nummer berücksichtigt nicht den Status ein-/ausgeblendet der Listbox-Zeilen. Es kann auch der Wert 0 sein, wenn der Klick oder die Y-Koordinate unter der letzten Zeile liegt.
Wird eine Zelle in einer Proforma Spalte angeklickt oder als X-Koordinate angegeben, enthält der Parameter Zeile "N+1". N ist die Anzahl der vorhandenen Spalten bei Klick in eine Zelle oder wenn es keine Spalte an der X-Position gibt. Eine Proforma Spalte lässt sich automatisch hinzufügen, wenn die Option "Spaltenbreite Automatisch" ausgewählt ist; weitere Informationen dazu finden Sie im Abschnitt Gruppe Vergrößerungsoptionen des Handbuchs 4D Designmodus.
In einer hierarchischen Listbox berücksichtigt der Spaltenwert die Spalte(n), die zur Darstellung der Hierarchie zusammengeführt wurden, wie im Absatz Auswahlen und Positionen verwalten erläutert.

Der optionale Parameter SpaltenVar gibt einen Zeiger auf die Variable zurück (z.B. Array), die der Spalte zugeordnet ist.

Ohne die Parameter X und Y lässt sich LISTBOX GET CELL POSITION 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, über Tastatur oder über den Befehl 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 - Is nil pointer zurück.

Siehe auch

LISTBOX GET CELL COORDINATES
LISTBOX SELECT BREAK