4D Doc Center : LISTBOX INSERT ROWS

4D v14.3

LISTBOX INSERT ROWS


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

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 objeto (se * for especificado) ou Variável (se * é omitido)
posiçao	Inteiro longo	Posição da fila a apagar
numFilas	Inteiro longo	Número de filas a inserir

Descrição

O comando LISTBOX INSERT ROWS 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 passar 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.

Por padrão, se o parâmetro numFilas for omitido, apenas uma linha é inserida. Caso contrário, o comando insere o número de linhas definidas neste parâmetro.

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

Se o parâmetro numFilas excede o número de linhas de tabelas nas arrays do list box, o comando executa a adição, no final de cada tabela. Se for igual a 0, o comando executa a adição no início de cada array. Se ele contém um valor negativo, o comando não faz nada.