4D Doc Center : SET LISTBOX TABLE SOURCE

4D v14.3

SET LISTBOX TABLE SOURCE


SET LISTBOX TABLE SOURCE ( {* ;} objeto ; numTabela \| tempo {; nomeSelecionado} )

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)
numTabela \| tempo	Inteiro longo, cadeia	Seleção temporária
nomeSelecionado	cadeia	Nome do conjunto selecionado

Descrição

O comando SET LISTBOX TABLE SOURCE permite modificar a fonte de dados mostrada no listbox desenhado pelos parâmetros * e objeto

Nota: este comando só pode ser utilizado quando a propriedade “Fonte de dados” do list box é Seleção atual ou Seleção temporária (para maior informação, consulte a seção Gestão de objetos List Box). O comando não faz nada se o utilizar com um list box associado com um array.

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

Se passa um número de tabela como parâmetro numTabela, o list box será preenchido com os dados dos registros na seleção atual da tabela.

Se passa um nome de seleção temporária como parâmetro tempo, o list box será preenchido com os dados dos registros que pertencem à seleção temporária.

O parâmetro opcional nomeSelecionado associa um conjunto de destacar com o list box. O conjunto de destacar gerencia destacando registro pelo usuário no list box.

Se o list box já conter as colunas, seus conteúdos são atualizados depois da execução do comando.

Nota: por razões de otimização, este comando é processado de maneira anacrônica, ou seja, a mudança de fonte do listbox é realizada apenas quando a execução do método do qual se chama o comando é completada.