LISTBOX SELECT BREAK

Home

4D v20 R7


LISTBOX SELECT BREAK ( {* ;} Objekt ; Zeile ; Spalte {; Aktion} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (string), ohne Stern: Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
Zeile	Lange Ganzzahl	Nummer der Umbruchzeile
Spalte	Lange Ganzzahl	Nummer der Umbruchspalte
Aktion	Lange Ganzzahl	Auswahl Aktion

Beschreibung

Der Befehl LISTBOX SELECT BREAK ermöglicht in der Listbox, definiert durch die Parameter * und Objekt, Umbruchzeilen auszuwählen. Die Listbox muss im hierarchischen Modus sein. Mit dem optionalen Parameter * geben Sie an, dass Objekt ein Objektname (String) ist. Ohne diesen Parameter geben Sie an, dass Objekt eine Variable ist. In diesem Fall übergeben Sie eine Variablenreferenz anstelle eines String.
Umbruchzeilen werden zur Darstellung der Hierarchie hinzugefügt, sie entsprechen aber nicht vorhandenen Zeilen im Array. Um eine Umbruchzeile zum Auswählen zu bestimmen, müssen Sie die Zeilen- und Spaltennummer übergeben, die dem ersten Auftreten im entsprechenden Array entspricht. Der Befehl LISTBOX GET CELL POSITION gibt diese Werte zurück, wenn der Benutzer eine Umbruchzeile ausgewählt hat. Weitere Informationen dazu finden Sie im Abschnitt Hierarchische Listboxen.

Der Parameter Aktion kann die Auswahlaktion so setzen, dass sie ausgeführt wird, wenn in der Listbox bereits eine Auswahl von Umbruchzeilen vorhanden ist. Sie können einen Wert oder eine der nachfolgenden Konstanten unter dem Thema Listbox übergeben:

Konstante	Typ	Wert	Kommentar
lk 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.
lk 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.
lk 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.

Hinweise: Haben Sie für die Listbox die Option Auswahlmarkierung ausblenden markiert:

Müssen Sie die Auswahlen in der Listbox über verfügbare Oberflächenoptionen sichtbar machen. Weitere Informationen dazu finden Sie im Abschnitt Darstellung von Auswahlen anpassen
Können Sie für hierarchische Listboxen keine Umbruchzeilen hervorheben. Weitere Informationen dazu finden Sie im Abschnitt Einschränkung bei hierarchischen Listboxen

Beispiel

Wir verwenden die folgenden Arrays in einer Listbox:

Wir möchten die Umbruchzeile "Hessen" auswählen:

 $row:=Find in array(T2;"Hessen")

 $column:=2

 LISTBOX COLLAPSE(*;"MeineListbox") `alle Ebenen zuklappen

 LISTBOX SELECT BREAK(*;"MeineListbox";$row;$column)

Hier ist das Ergebnis:

Siehe auch

LISTBOX GET CELL POSITION
LISTBOX SELECT ROW