LISTBOX GET ARRAYS

Home

4D v16.3

LISTBOX GET ARRAYS


LISTBOX GET ARRAYS ( {* ;} Objekt ; arrSpaNamen ; arrKopfNamen ; arrSpaVars ; arrKopfVars ; arrSpaSichtbar ; arrStile {; arrFußNamen ; arrFußVars} )

Parameter	Typ	Beschreibung
*	Operator	Mit * ist Objekt ein Objektname (String), Ohne * ist Objekt eine Variable
Objekt	Formularobjekt	Objektname (mit ) oder Variable (ohne )
arrSpaNamen	Array String	Objektnamen der Spalten
arrKopfNamen	Array String	Objektnamen des Kopfteils
arrSpaVars	Array Zeiger	Zeiger auf Spaltenvariablen oder Zeiger auf Spaltenfelder oder Nil
arrKopfVars	Array Zeiger	Zeiger auf Kopfteilvariablen
arrSpaSichtbar	Array Boolean	Spalte ein- oder ausgeblendet
arrStile	Array Zeiger	Zeiger auf Arrays oder Variablen für Stil, Farbe bzw. Zeilenkontrolle, oder Nil
arrFußNamen	Array String	Objektnamen Spaltenfußteile
arrFußVars	Array Zeiger	Zeiger auf Variablen der Spaltenfußteile

Beschreibung

Der Befehl LISTBOX GET ARRAYS gibt einen Satz synchronisierter Arrays zurück mit Information zu jeder Spalte (ein- oder ausgeblendet) 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.

Nach Ausführung des Befehls enthält:

Das Array arrSpaNamen die Liste der Objektnamen für jede Spalte in der Listbox.
Das Array arrKopfNamen die Liste der Objektnamen für jeden Spaltentitel in der Listbox.
Das Array arrSpaVars enthält für ein Array vom Typ Listbox Zeiger auf Variablen (Arrays) für jede Spalte in der Listbox. Bei Auswahlen vom Typ Listbox enthält arrSpaVars:
- Für Spalten, die einem Datenfeld zugeordnet sind, einen Zeiger auf das zugewiesene Datenfeld
- Für Spalten, die einer Variablen zugeordnet sind, einen Zeiger auf eine Variable
- Für Spalten, die einem Ausdruck zugeordnet sind, den Zeiger Nil

Das Array arrKopfVars die Zeiger auf Variablen (Arrays) für jeden Spaltentitel in der Listbox.
Das Array arrSpaSichtbar einen Boolean Wert für jede Spalte. Bei Wahr erscheint die Spalte in der Listbox, bei Falsch ist sie ausgeblendet.
Das Array arrStile enthält für ein Array vom Typ Listbox vier Zeiger auf vier Arrays, über die Sie jeder Zeile der Listbox einen bestimmten Stil, Farbe für Schrift oder Hintergrund und einen eigenen Status ausgeblendet zuweisen können. Diese Arrays werden der Listbox über die Eigenschaftenliste in der Designumgebung zugewiesen oder über den Befehl LISTBOX SET ARRAY. Ist ein Array für die Listbox nicht angegeben, enthält der entsprechende Eintrag in arrStile einen Zeiger Nil.
Der vierte Zeiger entspricht entweder einem Boolean Array (Array ausgeblendete Zeilen) oder einem Array Lange Ganzzahl (Array zum Setzen von ausgeblendeten, deaktivierten und nicht-auswählbaren Zeilen) basierend auf der Variante, die für das Array Zeilenkontrolle verwendet wird (siehe Eigenschaften für Listboxen). Ist ein Array für die Listbox nicht angegeben, enthält der entsprechende Eintrag in arrStile einen Zeiger Nil. Bei einer Listbox vom Typ Auswahl enthält arrStile:
- Für Konfigurationen über eine Variable einen Zeiger auf eine Variable
- Für Konfigurationen über einen Ausdruck den Zeiger Nil

Siehe auch

LISTBOX Get array
LISTBOX Get information
LISTBOX SET ARRAY