LISTBOX SET HIERARCHY

Home

4D v20 R7


LISTBOX SET HIERARCHY ( {* ;} Objekt ; hierarchisch {; Hierarchie} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (String), Ohne Stern: Objekt ist eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
hierarchisch	Boolean	Wahr = hierarchische Listbox, Falsch = nicht-hierarchische Listbox
Hierarchie	Array Zeiger	Array mit Zeigern

Beschreibung

Der Befehl LISTBOX SET HIERARCHY setzt die Listbox, definiert durch die Parameter Objekt und *, im hierarchischen bzw. nicht-hierarchischen Modus.

Hinweis: Dieser Befehl funktioniert nur mit Listboxen, die auf Arrays basieren. Bei Listboxen, die auf Auswahlen basiert, führt er nichts aus.

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.

Über den Boolean Parameter hierarchisch definieren Sie den Modus der Listbox:

Übergeben Sie Wahr, erscheint die Listbox im hierarchischen Modus
Übergeben Sie Falsch, erscheint die Listbox im nicht-hierarchischen Modus (Standard Array Modus)

Übergeben Sie eine Listbox im hierarchischen Modus, sind automatisch bestimmte Eigenschaften eingeschränkt. Weitere Informationen dazu finden Sie im Abschnitt Hierarchische Listboxen verwalten.

Mit dem Parameter Hierarchie definieren Sie die Arrays der Listbox zum Aufbau der Hierarchie. Lassen Sie diesen Parameter weg, passiert folgendes:

Ist die Listbox bereits im hierarchischen Modus, führt der Befehl nichts aus.
Ist die Listbox im nicht-hierarchischen Modus und wurde nie als hierarchisch deklariert, wird standardmäßig das erste Array für die Hierarchie verwendet.
Ist die Listbox im nicht-hierarchischen Modus, wurde aber zuvor als hierarchisch deklariert, wird die letzte Hierarchie wiederhergestellt.

Beispiel

Definition der Arrays arrLand, arrBundesland und arrStadt als Hierarchie einer Listbox:

 ARRAY POINTER($ArrHierarch;3)

 $ArrHierarch{1}:=->arrLand `Erste Umbruchebene

 $ArrHierarch{2}:=->arrBundesland `Zweite Umbruchebene

 $ArrHierarch{3}:=->arrStadt `Dritte Umbruchebene

 LISTBOX SET HIERARCHY(*;"Meinelistbox";True;$ArrHierarch)

Siehe auch

LISTBOX GET HIERARCHY