4D Doc Center : ARRAY TO LIST

4D v13.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

Beschreibung

Der Befehl ARRAY TO LIST erstellt oder ersetzt Liste (wie im Listeneditor der Designumgebung definiert) mit den Elementen von Array.

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 Einträge aus der Liste auf 1, 2... N.

Hinweis zur Kompatibilität: Verwenden Sie ARRAY TO LIST mit Bedacht, da es folgende Beschränkungen gibt:

Da dieser Befehl die Anwendungsstruktur verändert (Listen werden in der Strukturdatei gespeichert), gehen alle lokal ausgeführten Änderungen verloren, wenn die Strukturdatei während der Produktion aktualisiert wird.
Dieser Befehl lässt sich in einer Komponente nicht verwenden, da sie mit ihrer Struktur im Nur-Lesen Modus geladen wird.
Der Befehl kann nur die Einträge der 1. Ebene in der Liste definieren.

Mit ARRAY TO LIST können Sie weiterhin eine Liste mit den Elementen eines Array erstellen. Für den uneingeschränkten Einsatz von Listen mit Werten empfehlen wir, die Befehle im Kapitel Hierarchische Listen zu verwenden.

Beispiel

Folgendes Beispiel kopiert das Array atRegions in die Liste mit Namen “Regions:”

ARRAY TO LIST(atRegions;"Regions")

Fehlerverwaltung

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.