4D Doc Center : ARRAY TO LIST

Home

4D v14.3

ARRAY TO LIST


ARRAY TO LIST ( ArrayName ; Liste {; itemRefs} )

Parameter	Typ	Beschreibung
ArrayName	Array	Array, aus dem Array-Elemente zu kopieren sind
Liste	String, ListRef	Name oder Referenz der 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.

Im Parameter Liste können Sie eine Auswahlliste (String) oder Referenz auf eine hierarchische Liste (ListRef) übergeben. Bei ListRef funktioniert der Befehl nur, wenn die Liste bereits erstellt ist, z.B. über die Funktion New list.

Verwenden Sie den optionalen Parameter itemRefs, 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")

Beispiel

Nicht-wiederholte Werte eines Feldes in eine Liste setzen, um z.B. ein hierarchisches PopUp Menü zu erstellen. Sie schreiben wie folgt:

 ALL RECORDS([Company])

 DISTINCT VALUES([Company]country;$arrCountries)

 CountryList:=New list

 ARRAY TO LIST($arrCountries;CountryList)

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.