4D v14.3

ARRAY TO LIST

Home

 
4D v14.3
ARRAY TO LIST

ARRAY TO LIST 


 

ARRAY TO LIST ( ArrayName ; Liste {; itemRefs} ) 
Parameter Typ   Beschreibung
ArrayName  Array in Array, aus dem Array-Elemente zu kopieren sind
Liste  String, ListRef in Name oder Referenz der Liste, in die Array-Elemente zu kopieren sind
itemRefs  Array in Numerisches Array mit den Referenznummern der Items

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.

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

 ARRAY TO LIST(atRegions;"Regions")

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)

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.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Arrays
Nummer: 287

Dieser Befehl ändert die Systemvariable Error

 
GESCHICHTE 

New
Erstellt: < 4D v6
Geändert: 4D v14

 
SIEHE AUCH 

LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : ARRAY TO LIST ( 4D v11 SQL Release 6)