4D Doc Center : ARRAY TO LIST

4D v14.3

ARRAY TO LIST


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

Parâmetro	Tipo	Descrição
array	Array	Array do qual se copia os elementos de array
lista	cadeia, ListRef	Lista na qual se copia os elementos de array
itemRefs	Array	Arrays numéricos do número de referência dos elementos

Descrição

O comando ARRAY TO LIST cria ou substitui a lista hierárquica ou a lista usando os elementos do array.

Pode passar no parâmetro opcional lista, uma lista de seleção (cadeia) ou uma referência de lista hierárquica (refLista). No segundo caso, esta lista deve ter sido criada previamente (por exemplo utilizando o comando New list) para que este comando funcione.

O parâmetro opcional itemRefs, se especificado, deve ser um array numérico sincronizado com o array array. Cada elemento, então, indica o número de referência dos elementos da lista para o elemento correspondente no array. Se você omitir este parâmetro, 4D automaticamente determina os número de referência dos elementos da lista como 1, 2.

Nota de compatibilidade: O comando ARRAY TO LIST deve ser utilizado com precaução pelas seguintes limitações:

Este comando só lhe permite definir elementos de primeiro nível da lista.
Quando o utiliza como uma lista, este comando modifica a estrutura da aplicação (as listas se guardam no arquivo de estrutura), as modificações realizadas localmente se perdem quando se atualiza o arquivo de estrutura durante a produção.
Este comando não pode ser utilizado em um componente com uma lista de seleção porque os componentes estão carregados com a estrutura em modo de leitura.

Pode utilizar [#current_title para construir uma lista baseada nos elementos de um array. No entanto, para se livrar destas restrições e explorar por completo as listas de valores, lhe recomendamos utilizar os comandos do tema Listas Hierárquicas.

Exemplo

O exemplo seguinte copia o array atRegioes na lista “Regiões”

ARRAY TO LIST(atRegions;"Regions")

Exemplo

Você quer colocar os diferentes valores de um campo em uma lista, por exemplo para criar um menu pop-up hierárquico. Pode escrever:

 ALL RECORDS([Empresa])

 DISTINCT VALUES([Empresa]pais;$arrPaises)

 ListaPais:=New list

 ARRAY TO LIST($arrPaises;ListaPais)

Gestão de erros

O comando ARRAY TO LIST gera o erro -9957 quando é aplicado a uma lista que está atualmente sendo editada no Editor de Lista de Ambiente de Desenho.Você pode interceptar este erro usando um método de projeto ON ERR CALL.