4D v14.3

DELETE FROM LIST

Página Inicial

 
4D v14.3
DELETE FROM LIST

DELETE FROM LIST 


 

DELETE FROM LIST ( {* ;} lista ; refElem | * {; *} )  
Operador in Se especificada, lista é um nome de objeto (cadeia) Se omitida, lista é um número de referência de lista
lista  ListRef, cadeia in Número de referência de lista (se omitida *) ou Nome do objeto de tipo lista (se passada *)
refElem | *   Inteiro longo, Operador in Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
in Se especificada, apaga as sub-listas (se existem) da memória Se omitida, as sub-listas (se existem) não são apagadas

O comando DELETE FROM LIST apaga o elemento designado pelo parâmetro refElem da lista cujo número de referência se passa em lista.

Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação de lista no formulário. Se não passar este parâmetro, indica que o parâmetro lista é uma referencia de lista hierárquica (refLista). Se utilizar uma só representação de lista ou trabalha com todos os elementos (passa o segundo *), pode utilizar qualquer uma das duas sintaxes. Pelo contrário, se utilizar várias representações da mesma lista e trabalha com os elementos visíveis (o segundo * é omitido), a sintaxe baseada no nome do objeto é necessária já que cada representação pode ter sua própria configuração exibida/contraída.

Se passar * em refElem, apaga o elemento atualmente selecionado na lista. Igualmente pode passar 0 neste parâmetro para apagar o último elemento adicionado à lista.

Do contrário, especifique o número de referência do elemento que deseja apagar. Se o número não corresponde a nenhum elemento da lista, o comando não faz nada.

Se trabalhar com os números de referência dos elementos, construa uma lista na qual os elementos tenham números de referência únicos, do contrário não poderá distinguir os elementos. Para maior informação, consulte a descrição do comando APPEND TO LIST.

Sem importar que elemento apague, deve especificar o parâmetro opcional * para permitir a 4D apagar automaticamente a sub-lista associada ao elemento, se as houver. Se não especificar o parâmetro *, é uma boa idéia obter previamente o número de referência da sub-lista (se houver) associada ao elemento, de maneira que pode ser apagado, se for necessário, utilizando o comando CLEAR LIST.

Exemplo  

O código a seguir apaga o elemento selecionado da lista hList. Se o elemento tiver uma sub-lista associada for apagada (como também toda sub-sub lista):

 DELETE FROM LIST(hList;*;*)

 
PROPRIEDADES 

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

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

CLEAR LIST
GET LIST ITEM

 
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)