4D Doc Center : LISTBOX GET OBJECTS

Home

4D v14.3

LISTBOX GET OBJECTS


LISTBOX GET OBJECTS ( {* ;} Objekt ; arrObjektNamen )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist Objektname (String) Ohne Stern: Objekt ist Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
arrObjektNamen	Array Text	Namen der Unterobjekte mit Listbox (Kopfteil, Spalten, Fußteil)

Beschreibung

Der Befehl LISTBOX GET OBJECTS gibt ein Array mit den Namen jedes Objekts der Listbox zurück, definiert über die Parameter Objekt und *.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt eine Variable. In diesem Fall übergeben Sie eine Variablenreferenz anstelle eines String.

In arrObjektNamen übergeben Sie ein Array Text, das der Befehl automatisch füllt. Objektnamen werden in der Reihenfolge der Anzeige zurückgegeben, also wie folgt:

nameCol1

headerNameCol1

footerNameCol1

nameCol2

headerNameCol2

footerNameCol2

...

Das Array gibt die Objektnamen aller Spalten, inkl. Spaltenfußteile zurück, egal ob sie ein- oder ausgeblendet sind.

Dieser Befehl ist hilfreich, wenn ein Formular über die Routinen FORM LOAD, FORM GET OBJECTS und OBJECT Get type analysiert wird. Damit erhalten Sie bei Bedarf die Namen der Unterobjekte der Listbox.

Beispiel

Ein Formular laden und eine Liste mit allen Objekten in der Listbox erhalten.

 FORM LOAD("MyForm")

 ARRAY TEXT(arrObjects;0)

 FORM GET OBJECTS(arrObjects)

 ARRAY LONGINT(ar_type;Size of array(arrObjects))

 For($i;1;Size of array(arrObjects))

    ar_type{$i}:=OBJECT Get type(*;arrObjects{$i})

    If(ar_type{$i}=Object type listbox)

       ARRAY TEXT(arrLBObjects;0)

       LISTBOX GET OBJECTS(*;arrObjects{$i};arrLBObjects)

    End if

 End for

 FORM UNLOAD