4D Doc Center : ARRAY TO LIST

4D v13.4

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	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 lista (como definida no Editor de Lista de Ambiente de Desenho) usando os elementos do array array.

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 número de referência dos elementos da lista como 1, 2, … N.

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

Como 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 porque os componentes estão carregados com a estrutura em modo de leitura.
Este comando só lhe permite definir elementos de primeiro nível da lista.

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.

Example

O exemplo seguinte copia o array atRegioes para a lista chamada “Regiões”

ARRAY TO LIST(atRegioes;"Regioes")

Gestão de erros

O comando ARRAY TO LIST gera o erro -9957 quando o ARRAY TO LIST é 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.