4D v16.3

LISTBOX INSERT ROWS

Página Inicial

 
4D v16.3
LISTBOX INSERT ROWS

LISTBOX INSERT ROWS 


 

LISTBOX INSERT ROWS ( {* ;} objeto ; posiçao {; numFilas} )  
Parâmetro Tipo   Descrição
Operador in Se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável
objeto  Objeto de formulário in Nome objeto (se * for especificado) ou Variável (se * é omitido)
posiçao  Inteiro longo in Posição da fila a apagar
numFilas  Inteiro longo in Número de filas a inserir

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.



Ver também 

LISTBOX DELETE ROWS

 
PROPRIEDADES 

Produto: 4D
Tema: List Box
Número 913

Este comando modifica a variável sistema OK

 
HISTÓRIA 

Criado por: 4D 2004
Renomear: 4D v12
Modificado: 4D v13
Renomear: 4D v13

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)