4D v12.4LIST TO ARRAY |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v12.4
LIST TO ARRAY
|
LIST TO ARRAY ( Liste ; ArrayName {; itemRefs} ) | ||||||||
Parameter | Typ | Beschreibung | ||||||
Liste | String |
![]() |
Liste, aus der Einträge der 1. Ebene zu kopieren sind | |||||
ArrayName | Array |
![]() |
Array, in das Einträge der Liste zu kopieren sind | |||||
itemRefs | Array |
![]() |
Referenznummern für Einträge der Liste | |||||
Die Kompatibilität dieses Befehls ließ sich wegen der neu eingeführten Auswahllisten nicht voll erhalten. Von daher empfehlen wir, ab Version 6 die Funktion Load list zu verwenden und mit den hierarchischen Listen zu arbeiten, die in der Designumgebung im Listeneditor definiert sind.
Der Befehl LIST TO ARRAY erstellt oder überschreibt ArrayName mit den Einträgen der 1. Ebene aus Liste.
Haben Sie das Array zuvor nicht vom Typ Alphanumerisch oder Text definiert, erstellt LIST TO ARRAY standardmäßig ein Array vom Typ Text.
Der Parameter ItemRefs ist optional (ein numerisches Array). Er gibt die Referenznummern für Einträge in der Auswahlliste zurück.
Hinweis zur Kompatibilität: In vorherigen Versionen von 4D wurde dieses Array mit den Namen von beliebigen verknüpften Listen gefüllt. Hatte ein Element aus der Liste eine verknüpfte Liste, wurde der Name dieser verknüpften Liste in das Array-Element gesetzt, die dieselbe Nummer wie das Listenelement hatte. Gab es keine verknüpfte Liste, war das Element eine leere Zeichenkette. Das zweite Array wurde auf dieselbe Größe wie ArrayName gesetzt. Über die Namen in diesem Array hatten Sie Zugriff auf die verknüpften Listen.
Mit LIST TO ARRAY können Sie weiterhin Arrays mit Einträgen von der 1. Ebene einer hierarchischen Liste erstellen. Sie erhalten jedoch keine untergeordneten Einträge, sofern vorhanden. Verwenden Sie dafür die in Version 6 neueingeführten Befehle für hierarchische Listen.
Folgendes Beispiel kopiert die Einträge der Liste Regions in ein Array mit Namen atRegions:
LIST TO ARRAY("Regions";atRegions)
Produkt: 4D
Thema: Arrays
Nummer:
288
Erstellt: < 4D v6
ARRAY TO LIST
Load list
SAVE LIST