4D Doc Center : LISTBOX SELECT ROW

Home

4D v14.3

LISTBOX SELECT ROW


LISTBOX SELECT ROW ( {* ;} Objekt ; ZeilePosition {; Aktion} )

Parameter	Typ	Beschreibung
*	Operator	Mit : Objekt ist ein Objektname(string), Ohne : Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
ZeilePosition	Lange Ganzzahl	Nummer der zu wählenden Zeile
Aktion	Lange Ganzzahl	Auswahlaktion

Beschreibung

Der Befehl LISTBOX SELECT ROW wählt die Zeile mit der in PositionZeile übergebenen Nummer in der Listbox, definiert durch die Parameter Objekt und *.

Mit dem optionalen Parameter * geben Sie an, dass Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt eine Variable, d.h. Sie übergeben keinen String, sondern die Referenz auf eine Variable. Weitere Informationen zu Objektnamen finden Sie im Abschnitt Objekteigenschaften.

Mit dem optionalen Parameter Aktion definieren Sie die auszuführende Auswahlaktion, wenn es in der Listbox bereits eine Zeilenauswahl gibt. Sie können eine der vordefinierten Konstanten aus dem Thema Listbox übergeben:

Konstante	Typ	Wert	Meldung
Listbox add to selection	Lange Ganzzahl	1	Die ausgewählte Zeile wird der vorhandenen Auswahl hinzugefügt. Gehört die angegebene Zeile bereits zur Auswahl, führt die Konstante nichts aus.
Listbox remove from selection	Lange Ganzzahl	2	Die ausgewählte Zeile wird aus der vorhandenen Auswahl entfernt. Gehört die angegebene Zeile nicht zur Auswahl, führt die Konstante nichts aus.
Listbox replace selection	Lange Ganzzahl	0	Die gewählte Zeile wird zur neuen Auswahl und ersetzt die vorhandene Auswahl. Die Konstante hat dieselbe Wirkung wie Anklicken der Zeile durch den Benutzer (Das Ereignis On Clicked wird dagegen nicht generiert). Dies ist die Standardaktion, d.h. wenn der Parameter Aktion nicht verwendet wird.

Entspricht der Parameter PositionZeile nicht exakt einer vorhandenen Zeilennummer, arbeitet der Befehl folgendermaßen:

Ist PositionZeile <0, führt der Befehl nichts aus, unabhängig vom Wert im Parameter Aktion.
Ist PositionZeile gleich 0 und enthält der Parameter Aktion die Konstante Listbox replace selection oder wird er nicht verwendet, werden alle Zeilen der Listbox ausgewählt. Enthält der Parameter Aktion die Konstante Listbox remove from selection, werden alle Zeilen der Listbox abgewählt.
Ist der Wert von PositionZeile größer als die Gesamtanzahl der Zeilen in der Listbox, wird das zugewiesene Array vom Typ Boolean automatisch angepasst und dann die Auswahl ausgeführt. Diese Arbeitsweise bedeutet, dass Sie den Befehl LISTBOX SELECT ROW mit der Befehlen zur Standardverwaltung von Arrays verwenden (z.B. APPEND TO ARRAY), die nicht automatisch die unmittelbare Anpassung der Listbox auslösen.
Nach Ausführung der Methode werden die Arrays synchronisiert: Wurde das Ursprungsarray der Listbox tatsächlich angepasst, wird die Aktion Auswahl ausgeführt. Andernfalls kehrt das der Listbox zugewiesene Array vom Typ Boolean zur anfänglichen Größe zurück und der Befehl führt nichts aus.

Hinweise:

Soll die Listbox automatisch scrollen, um die gewählte Zeile auszuwählen, verwenden Sie den Befehl OBJECT SET SCROLL POSITION.
Soll eine Zeile in den Bearbeitungsmodus wechseln, um Daten eingeben zu können, wählen Sie den Befehl EDIT ITEM.
Gehört die in PositionZeile übergebene Nummer zu einer ausgeblendeten Zeile in der Listbox, wird die Zeile ausgewählt, aber nicht angezeigt.