4D v14.3

SELECT LISTBOX ROW

Página Inicial

 
4D v14.3
SELECT LISTBOX ROW

SELECT LISTBOX ROW 


 

SELECT LISTBOX ROW ( {* ;} objeto ; posiçao {; açao} )  
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 Número da fila a selecionar
açao  Inteiro longo in Ação de seleçã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.

 
PROPRIEDADES 

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

 
HISTÓRIA 

Modificado: 4D v11 SQL Release 2
Renomear: 4D v12

 
VER TAMBÉM 

DELETE LISTBOX ROWS
EDIT ITEM
LISTBOX INSERT ROWS
LISTBOX SELECT BREAK
OBJECT SET SCROLL POSITION

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Inherited from : SELECT LISTBOX ROW ( 4D v12.4)