4D v12.4

ARRAY TO LIST

Página Inicial

 
4D v12.4
ARRAY TO LIST

 

ARRAY TO LIST 


 

ARRAY TO LIST ( array ; lista {; itemRefs} ) 
Parâmetro Tipo   Descrição
array  Array in Array do qual se copia os elementos de array
lista  cadeia in Lista na qual se copia os elementos de array
itemRefs  Array in 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.

Example  

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Arrays
Número 287

Este comando modifica a variável sistema Error

 
HISTÓRIA 

Criado por: < 4D v6

 
VER TAMBÉM 

LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST