4D Doc Center : DELETE LISTBOX ROWS

4D v14.3

DELETE LISTBOX ROWS


DELETE LISTBOX ROWS ( {* ;} objeto ; posiçao {; numRows} )

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string) se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se * é especificado) ou Variável (se * é omitido)
posiçao	Inteiro longo	Posição da fila a apagar
numRows	Inteiro longo	Número de linhas a excluir

Descrição

O comando DELETE LISTBOX ROWS apaga a fila número posição (visível ou não) do list box definido pelos parâmetros objeto e *.

Nota: este comando funciona apenas com os list box baseados em arrays. Quando este comando se utiliza com um list box baseado em uma seleção, não faz nada e a variável sistema OK retorna 0

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se omitir este parâmetro, indica que o parâmetro objeto é uma variável. Nesse caso, não passa uma string, mas uma referência de variável. Para maior informação sobre nomes de objetos, consulte a seção Propriedades dos objetos

Lembre que depois da execução do comando, não haverá nenhum elemento selecionado no list box.

A fila posição é eliminada automaticamente de todos os arrays utilizados pelas colunas do list box.
Se o parâmetro posição é superior ao número de linhas do array do list box ou se é inferior a 1, o comando não faz nada.

Nota: este comando não considera os possíveis estados ocultos/visíveis das linhas do list box.