4D v14.3

CLEAR LIST

Página Inicial

 
4D v14.3
CLEAR LIST

CLEAR LIST 


 

CLEAR LIST ( lista {; *} ) 
lista  ListRef in Número de referência da lista
in Se especificada, se há sub-listas se deve apagar da memória, Se omitida, as sub-listas não são apagadas

O comando CLEAR LIST apaga da memória a lista hierárquica cujo número de referência é passado em lista.

Geralmente deve passar o parâmetro opcional *, de maneira que todas as sub-listas, se as houver, associadas aos elementos ou sub elementos da lista também sejam apagados.

Não é necessário apagar uma lista associada a um objeto de formulário através da janela da Lista de propriedades. 4D carrega e apaga a lista por você. Por outra parte, cada vez que você carrega, copia, extrai de um BLOB, ou cria uma lista por programação, chama ao comando CLEAR LIST quando não necessitar mais a lista.

Para apagar uma sub-lista associada a um elemento (em qualquer nível) de outra lista mostrada atualmente em um formulário, aja da seguinte forma:

1.Chame GET LIST ITEM com o elemento pai para obter o número de referência da sub-lista.
2. Chame SET LIST ITEM com o elemento pai para separar a sub-lista do elemento da lista antes de apagá-los.
3. Chame CLEAR LIST para apagar a sub-lista cujo número de referência obteve com GET LIST ITEM.
4. Chame REDRAW LIST para a lista mostrada no formulário, para recalcular seus elementos e sub-listas.

Dentro de uma rotina de limpeza que apaga todos os objetos e dados que já não necessita (por exemplo, quando se fecha uma janela ou um formulário), poderia terminar apagando uma lista hierárquica que já tenha sido apagada, dependendo das ações do usuário no formulário. Utilize Is a list para apagar a lista só se for necessário:

  ` Extrair da rotina de limpeza
 If(Is a list(hlList))
    CLEAR LIST(hlList;*)
 End if

Ver o exemplo do comando Load list.

Ver o exemplo do comando BLOB to list.

 
PROPRIEDADES 

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

 
HISTÓRIA 

Criado por: 4D v6

 
VER TAMBÉM 

BLOB to list
Load list
New 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)