4D v14.3

Load list

Página Inicial

 
4D v14.3
Load list

Load list 


 

Load list ( nomeLista ) -> Resultado 
Parâmetro Tipo   Descrição
nomeLista  cadeia in Nome de uma lista criada no Editor de listas do ambiente Desenho
Resultado  ListRef in Número de referência da lista criada recentemente

Load list cria uma lista hierárquica cujo conteúdo é copiado da lista passada em nomeLista. Depois retorna o número de referência da lista criada recentemente.

Para ter certeza de que a lista especificada por nomeLista existe, utilize a função Is a list.

Note que a nova lista é uma cópia da lista definida no ambiente Desenho. Portanto, qualquer modificação realizada à nova lista não afetará a lista definida no ambiente Desenho. Da mesma maneira, toda modificação posterior à lista definida no ambiente Desenho não afetará a lista que acaba de criar.

Se modificar a lista criada recentemente e deseja guardar as mudanças de forma permanente, chame ao comando SAVE LIST.

Lembre chamar CLEAR LIST para apagar a lista criada quando tenha terminado. Do contrário, permanecerá em memória até o final da sessão de trabalho ou até que o processo no qual foi criada termine ou seja abortado.

Dica: se associar uma lista a um objeto de formulário (lista hierárquica, aba, ou menu hierárquico) utilizando Lista de valores na janela de Lista de propriedades, não necessita chamar Load list ou CLEAR LIST no método do objeto. 4D carrega e apaga a lista automaticamente pra você.

Exemplo  

Você cria um banco para o mercado internacional e necessita mudar aos diferentes idiomas enquanto utiliza o banco. Em um formulário, apresenta uma lista hierárquica, chamada hlList, que oferece uma lista de opções padrão. No ambiente Desenho, você preparou várias listas, tais como “Opções EN” para a versão em inglês, “Opções FR” para a versão em francês, “Opções ES” para a versão em espanhol, etc. Adicionalmente, você mantém uma variável interprocesso chamadagsIdiomaAtual, onde armazena um código de linguagem de 2 caracteres, como “EN” para a versão em inglês, “FR” para a verão em francês, “ES” para a verão em espanhol, etc. Para ter certeza de que se carregue a lista correta utilizando o idioma selecionado atualmente, pode escrever:

  ` Método de objeto da lista hierárquica hlList
 Case of
    :(Form event=On Load)
       C_LONGINT(hlList)
       hlList:=Load list("Std Options"+◊gsIdiomaAtual)
    :(Form event=On Unload)
       CLEAR LIST(hlList;*)
 End case

 
PROPRIEDADES 

Produto: 4D
Tema: Listas Hierárquicas
Número 383

 
HISTÓRIA 

Criado por: 4D v6

 
VER TAMBÉM 

CLEAR LIST
Is a list
SAVE LIST

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)