4D Doc Center : Load list

4D v14.3

Load list


Load list ( nomeLista ) -> Resultado

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

Descrição

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 chamada◊gsIdiomaAtual, 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