4D v12.4ARRAY TO LIST |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v12.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 | |||||
Devido às novas implementações das Listas de Escolhas, a compatibilidade para este comando não pôde ser mantida em sua totalidade, iniciando na versão 6. Nós recomendamos que você use o comando SAVE LIST ao trabalhar com as listas hierárquicas definidas no Editor de Lista de Ambiente de Design.
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.
Este comando permite que você define apenas os itens de primeiro nível da lista.
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: Na versão anterior de 4D, este parâmetro era usado para ligar outras listas a cada elemento do array. Se um elemento do array links fosse o nome de uma lista existente, então esta lista seria anexada ao item correspondente.
Você pode continuar a usar o comando ARRAY TO LIST para construir uma lista baseada nos elementos de um array. Contudo, este comando não oferece os meios necessários para se trabalhar com sub-listas. Para trabalhar com listas hierárquicas, use o novo comando de Listas Hierárquicas introduzido na versão 6.
O exemplo seguinte copia o array atRegioes para a lista chamada “Regiões”
ARRAY TO LIST(atRegioes;"Regioes")
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.
Produto: 4D
Tema: Arrays
Número
287
Criado por: < 4D v6
LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST