Version 3
Hinweis zur Kompatibilität
Die Kompatibilität dieses Befehls ließ sich wegen der neu eingeführten Auswahllisten nicht voll erhalten. Von daher empfehlen wir, ab Version 6 den Befehl SAVE LIST zu verwenden und mit den hierarchischen Listen zu arbeiten, die in der Designumgebung im Listeneditor definiert sind.
ARRAY TO LIST (Array; Auswahlliste{; itemRefs})
Parameter | Typ | Beschreibung | |
Array | Array | Array, aus dem Array-Elemente zu kopieren sind | |
Auswahlliste | String | Liste, in die Array-Elemente zu kopieren sind | |
itemRefs | Array | Numerisches Array mit den Referenznummern | |
der Items |
Beschreibung
Der Befehl ARRAY TO LIST erstellt oder ersetzt Auswahlliste (wie im Listeneditor der Designumgebung definiert) mit den Elementen von Array.
Der Befehl kann nur die Items der 1. Ebene in der Liste definieren.
Der Parameter itemRefs ist optional. Verwenden Sie ihn, muß er ein numerisches Array sein, das mit Array synchronisiert ist. Jedes Element gibt dann die Referenznummer der Items aus der Liste für das entsprechende Element in Array an. Verwenden Sie ihn nicht, setzt 4D automatisch die Referenznummer der Items aus der Liste auf 1, 2... N.
Hinweis zur Kompatibilität: In vorherigen Versionen von 4D ließen sich über diesen Parameter andere Listen mit jedem Element in Array verknüpfen. War ein Element des Array Verknüpfung der Name einer vorhandenen Liste, wurde diese an das entsprechende Item angehängt.
Mit ARRAY TO LIST können Sie weiterhin eine Liste mit den Elementen eines Array erstellen. Sie erhalten jedoch keine untergeordneten Items, sofern vorhanden. Verwenden Sie dafür die in Version 6 neueingeführten Befehle für hierarchische Listen.
Beispiel
Folgendes Beispiel kopiert das Array atRegions in die Liste mit Namen "Regions:"
ARRAY TO LIST (atRegions;"Regions")
Referenz
LIST TO ARRAY, Load list, ON ERR CALL, SAVE LIST.
Error Handling
Der Fehler -9957 tritt auf, wenn ARRAY TO LIST auf eine Liste angewendet wird, die gerade in der Designumgebung im Listeneditor angelegt wird. Sie können diesen Fehler mit einer Projektmethode ON ERR CALL abfangen.