4D v12.4ARRAY TO LIST |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v12.4
ARRAY TO LIST
|
ARRAY TO LIST ( ArrayName ; Liste {; itemRefs} ) | ||||||||
Parameter | Typ | Beschreibung | ||||||
ArrayName | Array |
![]() |
Array, aus dem Array-Elemente zu kopieren sind | |||||
Liste | String |
![]() |
Liste, in die Array-Elemente zu kopieren sind | |||||
itemRefs | Array |
![]() |
Numerisches Array mit den Referenznummern der Items | |||||
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.
Der Befehl ARRAY TO LIST erstellt oder ersetzt Liste (wie im Listeneditor der Designumgebung definiert) mit den Elementen von Array.
Der Befehl kann nur die Einträge der 1. Ebene in der Liste definieren.
Der Parameter itemRefs ist optional. Verwenden Sie ihn, muss er ein numerisches Array sein, das mit Array synchronisiert ist. Jedes Element gibt dann die Referenznummer der Einträge 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 den entsprechenden Eintrag angehängt.
Mit ARRAY TO LIST können Sie weiterhin eine Liste mit den Elementen eines Array erstellen. Sie erhalten jedoch keine untergeordneten Einträge, sofern vorhanden. Verwenden Sie dafür die in Version 6 neu eingeführten Befehle für hierarchische Listen.
Folgendes Beispiel kopiert das Array atRegions in die Liste mit Namen “Regions:”
ARRAY TO LIST(atRegions;"Regions")
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.
Produkt: 4D
Thema: Arrays
Nummer:
287
Erstellt: < 4D v6
LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST