ARRAY TO LIST

4D v20 R7

ARRAY TO LIST


ARRAY TO LIST ( array ; lista {; refElementos} )

Parámetro	Tipo	Descripción
array	Array	Array del cual copiar los elementos del array
lista	Cadena, ListRef	Lista en la cual copiar los elementos del array
refElementos	Array	Array numérico de números de referencia de los elementos

Descripción

El comando ARRAY TO LIST crea o reemplaza la lista jerárquica o la lista utilizando los elementos del array.

Puede pasar en el parámetro opcional lista, una lista de selección (cadena) o una referencia de lista jerárquica (refLista). En el segundo caso, esta lista debe haber sido creada previamente (por ejemplo utilizando el comando New list) para que este comando funcione.

El parámetro opcional refElementos, si se pasa, debe ser un array numérico sincronizado con el array array. Cada elemento de este array indica el número de referencia del elemento de la lista correspondiente en array. Si omite este parámetro, 4D define automáticamente los números de referencia de los elementos de la lista 1, 2.

Nota de compatibilidad: el comando ARRAY TO LIST debe utilizarse con precaución por las siguientes limitaciones:

Este comando permite definir solamente los elementos del primer nivel de la lista.
Cuando lo utiliza con una lista, este comando modifica la estructura de la aplicación (las listas se guardan en el archivo de estructura), las modificaciones efectuadas en local se pierden durante la actualización del archivo de estructura en producción.
Este comando no puede utilizarse con una lista de selección en una estructura cargada en sólo lectura, tal como un proyecto .4dz project o un componente.

Puede utilizar ARRAY TO LIST para construir una lista basada en los elementos de un array. Sin embargo, para librarse de estas restricciones y explotar por completo las listas de valores, le recomendamos utilizar los comandos del tema Listas jerárquicas.

Ejemplo

El siguiente ejemplo copia el array atRegiones en la lista “Regiones:”

ARRAY TO LIST(atRegions;"Regions")

Ejemplo

Usted quiere poner los distintos valores de un campo en una lista, por ejemplo para crear un menú pop-up jerárquico. Puede escribir:

 ALL RECORDS([Empresa])

 DISTINCT VALUES([Empresa]pais;$arrPaises)

 ListaPais:=New list

 ARRAY TO LIST($arrPaises;ListaPais)

Gestión de errores

El comando ARRAY TO LIST genera el error -9957 cuando se aplica a una lista que está siendo editada en el editor de listas del entorno Diseño. Puede interceptar este error utilizando un método de proyecto ON ERR CALL.

Ver también

LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST