4D Doc Center : INSERT LISTBOX ROW

4D v12.4

INSERT LISTBOX ROW


INSERT LISTBOX ROW ( {* ;} objeto ; posiçao )

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

Descrição

O comando LISTBOX INSERT ROW insere uma nova linha no list box designado pelos parâmetros objeto e *.

Nota: este comando funciona unicamente com os list box baseados em arrays. Quando este comando é utilizado com um list box baseado em uma seleção, não faz nada e a variável sistema OK toma o valor 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 .

A fila é inserida na posição definida pelo parâmetro posição. Uma nova fila é adicionada automaticamente nesta posição em todos os arrays utilizados pelas colunas do list box, qualquer que seja seu tipo e visibilidade.

Se o valor de posição é maior que o número total de filas no list box, a fila é adicionada ao final de cada array. Se for igual a 0, a fila é adicionada ao princípio de cada array. Se conter um valor negativo, o comando não faz nada.