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