LISTBOX GET CELL POSITION

4D v16.3


LISTBOX GET 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 LISTBOX GET 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.

Notas:

O número retornado no parâmetro linha não leva em consideração estados escondidos/exibidos de linhas list box.
Se uma célula em uma coluna falsa for clicada, o parâmetro linha contém contains "X+1", onde X é o número de colunas existentes. (Uma coluna falsa pode ser adicionada automaticamente quando a opção "Redimensionamento de coluna" for selecionada; para saber mais, veja o parágrafo Redimensionar tema Opcoes).

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.

Ver também

LISTBOX GET CELL COORDINATES
LISTBOX SELECT BREAK