LISTBOX GET ARRAYS

Home

4D v20 R7

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 Text	Objektnamen der Spalten
arrKopfNamen	Array Text	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 Text	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 *.

Hinweis: Dieser Befehl lässt sich nur verwenden, wenn die Eigenschaft „Datenquelle“ der Listbox auf Aktuelle Auswahl oder Temporäre Auswahl gesetzt ist. Weitere Informationen dazu finden Sie im Abschnitt Einführung in Listboxen. Er führt nichts aus, wenn Sie ihn mit einer Listbox vom Typ Array, Collection oder Entity-Selection verwenden.

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 Is nil pointer

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 Is nil pointer.
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 Is nil pointer.
Bei einer Listbox vom Typ Auswahl und Collection enthält arrStile:
- Für Konfigurationen über eine Variable einen Zeiger auf eine Variable
- Für Konfigurationen über einen Ausdruck den Zeiger Is nil pointer

Siehe auch

LISTBOX Get array
LISTBOX Get property
LISTBOX SET ARRAY