4D v14.3

ARRAY TO LIST

Página Inicial

 
4D v14.3
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, ListRef in Lista na qual se copia os elementos de array
itemRefs  Array in Arrays numéricos do número de referência dos elementos

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)

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.

 
PROPRIEDADES 

Produto: 4D
Tema: Arrays
Número 287

Este comando modifica a variável sistema Error

 
HISTÓRIA 

New
Criado por: < 4D v6
Modificado: 4D v14

 
VER TAMBÉM 

LIST TO ARRAY
Load list
ON ERR CALL
SAVE LIST

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : ARRAY TO LIST ( 4D v11 SQL Release 6)