4D Doc Center : LISTBOX EXPAND

4D v13.4

LISTBOX EXPAND


LISTBOX EXPAND ( {* ;} Objekt {; rekursiv {; Selector {; Linie \| Ebene {; Spalte}}}} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (String), Ohne Stern: Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
rekursiv	Boolean	Wahr = erweiterte Unterebenen, Falsch = Unterebenen nicht erweitert
Selector	Lange Ganzzahl	Teil der Listbox, die erweitert werden soll.
Linie \| Ebene	Lange Ganzzahl	Nummer der Umbruchzeile
Spalte	Lange Ganzzahl	Nummer der Umbruchspalte

Beschreibung

Mit dem Befehl LISTBOX EXPAND können Sie die Umbruchzeilen des Objekts Listbox erweitern, definiert durch die Parameter Objekt und *.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter 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.
Ist die Listbox nicht im hierarchischen Modus angelegt, führt der Befehl nichts aus. Weitere Informationen dazu finden Sie im Abschnitt Hierarchische Listboxen verwalten.

Mit dem optionalen Parameter rekursiv konfigurieren Sie das Erweitern der hierarchischen Unterebenen der Listbox. Übergeben Sie Wahr oder lassen Sie diesen Parameter weg, um alle Ebenen und Unterebenen zu erweitern. Übergeben Sie Falsch, wird nur die erste Ebene erweitert.

Mit dem optionalen Parameter Selector geben Sie die Reichweite des Befehls an. Sie können eine der folgenden Konstanten unter dem Thema Listbox übergeben:

Konstante	Typ	Wert	Meldung
Listbox all	Lange Ganzzahl	0	Der Befehl betrifft alle Unterebenen (Standardwert, wird ohne diesen Parameter verwendet)
Listbox selection	Lange Ganzzahl	1	Befehl gilt für ausgewählte Unterebenen.
Listbox break row	Lange Ganzzahl	2	Der Befehl gilt für die Unterebene, zu der die Zelle, definiert mit den Parametern Zeile und Spalte, gehört. Beachten Sie, dass diese Parameter die Zeilen- und Spaltennummern in der Listbox im Standardmodus darstellen und nicht in der hierarchischen Form. In diesem Fall führt der Befehl nichts aus, wenn die Parameter Zeile und Spalte weggelassen werden.
Listbox level	Lange Ganzzahl	3	Dieser Befehl betrifft alle Umbruchzeilen für die Spalte Ebene. Dieser Parameter bezeichnet eine Spaltennummer in der Listbox im Standardmodus und nicht in seiner hierarchischen Darstellung. In diesem Fall führt der Befehl nichts aus, wenn der Parameter Ebene weggelassen wird.

Dieser Befehl wählt keine Umbruchzeilen aus.

Enthält die Auswahl oder Listbox keine Umbruchzeile oder sind alle Umbruchzeilen bereits erweitert, führt der Befehl nichts aus.

Beispiel

Dieses Beispiel zeigt verschiedene Wege für den Befehl. Wir verwenden die folgenden Arrays in einer Listbox:

  //Erweitere alle Umbruchzeilen und Umbruch-Unterzeilen für die Listbox

 LISTBOX EXPAND(*;"MeineListbox")

  //Erweitere die erste Ebene der Umbruchzeilen für die Auswahl

 LISTBOX EXPAND(*;"MeineListbox";False;Listbox selection)

  //wenn die Zeile "Frankreich" ausgewählt wurde:

  //Erweitere die Umbruchzeile Bayern mit Rekursion

 LISTBOX EXPAND(*;"MeineListbox";False;Listbox break row;1;2)

  //Erweitere alle ersten Spalten (Länder) ohne Rekursion

 LISTBOX EXPAND(*;"MeineListbox";False;Listbox level;1)