ARRAY TO LIST

4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

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})

ParameterTypBeschreibung
ArrayArrayArray, aus dem Array-Elemente zu kopieren sind
AuswahllisteStringListe, in die Array-Elemente zu kopieren sind
itemRefsArrayNumerisches 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.


4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next