4D Doc Center : GET LISTBOX CELL POSITION

4D v14.3

GET LISTBOX CELL POSITION


GET LISTBOX CELL POSITION ( {* ;} objeto ; coluna ; linha {; varCol} )

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)
coluna	Inteiro longo	Número de coluna
linha	Inteiro longo	Número da fila
varCol	Ponteiro	Ponteiro para a variável coluna

Descrição

O comando GET LISTBOX CELL POSITION devolve os números da coluna e da fila correspondentes a localização do último clique ou da última seleção realizada com o teclado en el listbox designado por * e objeto.

Este comando devolve as coordenadas de um clique ou de uma ação de seleção mesmo quando a entrada de dados não é permitida no list box.

Se passa o parâmetro opcional *, indica que o parâmetro objeto es um nome de objeto (cadena). Se omitir este parâmetro, indica que o parâmetro objeto é uma variável.

O parâmetro opcional varCol devolve um ponteiro a variável (ou seja para o array) associado com a coluna.

Este comando só pode ser chamado no marco de um list box que gera um dos seguintes eventos de formulário:

On Clicked e On Double Clicked
On Before Keystroke e On After Keystroke
On After Edit
On Getting Focus e On Losing Focus
On Data Change
On Selection Change
On Before Data Entry

Quando o comando é chamado fora deste contexto, LISTBOX GET CELL POSITION devolve 0 em coluna e fila.

Este comando leva em consideração as ações de seleção ou deseleção realizadas com o mouse, com o teclado, ou utilizando o comando EDIT ITEM (o qual gera o evento On Getting Focus).

Se a seleção é modificada utilizando as flechas do teclado, coluna devolve 0. Nesse caso, o parâmetro varCol devolve Nil se for passado.

Os valores devolvidos pelo comando não são atualizados no caso de um clique direito (ou Control+clique em Mac OS) no título de uma coluna do list box.