LIST TO ARRAY

Version 3

Die Kompatibilität dieses Befehls ließ sich wegen der neu eingeführten Auswahllisten nicht voll erhalten. Von daher empfehlen wir, ab Version 6 die Funktion Load list zu verwenden und mit den hierarchischen Listen zu arbeiten, die in der Designumgebung im Listeneditor definiert sind.

LIST TO ARRAY (Auswahlliste; Array{; ItemRefs})

Der Befehl LIST TO ARRAY erstellt oder überschreibt Array mit den Items der 1. Ebene aus Auswahlliste.

Haben Sie das Array zuvor nicht vom Typ Alphanumerisch oder Text definiert, erstellt LIST TO ARRAY standardmäßig ein Array vom Typ Text.

Der Parameter ItemRefs ist optional (ein numerisches Array). Er gibt die Referenznummern für Items der Auswahlliste zurück.

Hinweis zur Kompatibilität: In vorherigen Versionen von 4D wurde dieses Array mit den Namen von beliebigen verknüpften Listen gefüllt. Hatte ein Element aus der Liste eine verknüpfte Liste, wurde der Name dieser verknüpften Liste in das Array-Element gesetzt, die dieselbe Nummer wie das Listenelements hatte. Gab es keine verknüpfte Liste, war das Element eine leere Zeichenkette. Das zweite Array wurde auf dieselbe Größe wie Array gesetzt. Über die Namen in diesem Array hatten Sie Zugriff auf die verknüpften Listen.

Mit LIST TO ARRAY können Sie weiterhin Arrays mit Items von der 1. Ebene einer hierarchischen Liste erstellen. Sie erhalten jedoch keine untergeordneten Items, sofern vorhanden. Verwenden Sie dafür die in Version 6 neueingeführten Befehle für hierarchische Listen.

Folgendes Beispiel kopiert die Items der Liste Regions in ein Array mit Namen atRegions:

   LIST TO ARRAY ("Regions"; atRegions )

ARRAY TO LIST, Load list, SAVE LIST.

Anwendung des Befehls

Combo Box, Email–Embedded Tags, Popup Lists

---