4D Doc Center : SELECT LISTBOX ROW

4D v14.3

SELECT LISTBOX ROW


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

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	Número da fila a selecionar
açao	Inteiro longo	Ação de seleção

Descrição

O comando SELECT LISTBOX ROW seleciona a fila cujo número é passado em posição no list box designado pelos parâmetros objeto e *.

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.

O parâmetro opcional ação, se for passado, se utiliza para definir a ação de seleção a executar quando uma seleção de filas já existe no list box. Pode passar um valor ou uma das seguintes constantes (localizadas no tema “List box”):

Constante	Tipo	Valor	Comentário
Listbox add to selection	Inteiro longo	1	A linha selecionada é adicionada à seleção existente. Se a linha selecionada já pertence à seleção existente, o comando não faz nada.
Listbox remove from selection	Inteiro longo	2	A linha selecionada é removida da seleção existente. Se a linha especificada não pertence à seleção existente, o comando não faz nada.
Listbox replace selection	Inteiro longo	0	A linha selecionada torna-se a nova seleção e substitui a seleção existente. O comando tem o mesmo efeito que um clique do usuário em uma linha (no entanto, o evento On Clicked não é gerado). Esta é a ação padrão (se o parâmetro ação é omitido).

Quando o parâmetro posição não corresponde exatamente a um número de fila existente, o comando atua da seguinte maneira:

Se posição é <0, o comando não faz nada, qualquer que seja o valor do parâmetro ação.
Se posição é 0 e o parâmetro ação contém Listbox replace selection ou é omitido, todas as filas do list box são selecionadas. Se o parâmetro ação contém Listbox remove from selection, todas as filas do list box são desmarcadas.
Se o valor de posição é superior ao número total de filas contidas no list box (só no caso de um array de tipo listbox), ou array booleano associado ao list box é redimensionado automaticamente e a ação de seleção é realizada. Este mecanismo permite utilizar SELECT LISTBOX ROW com os comandos “padrão” de gestão de arrays (tais como APPEND TO ARRAY) que não provocam a sincronização imediata do listbox.

Depois da execução do método, os arrays são sincronizados: se o array fonte do listbox for redimensionado efetivamente, a ação de seleção é realizada. Do contrário, o array booleano associado com o list box volta ao seu tamanho inicial e o comando não faz nada.

Notas:

Se deseja que o list box tenha rolagem automaticamente para mostrar a fila selecionada, utilize o comando OBJECT SET SCROLL POSITION .
Para passar uma fila a modo edição (para permitir a entrada de dados), utilize o comando EDIT ITEM.
Se o número passado em posição corresponde a uma linha oculta no listbox, a linha é selecionada mas não é mostrada.