LISTBOX GET CELL POSITION

4D v20.6


LISTBOX GET CELL POSITION ( {* ;} objeto {; X ; Y }; 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)
X	Real	Horizontal coordinate of mouse
Y	Real	Vertical coordinate of mouse
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 no list box (designado por * e objeto) do último clique ou as coordenadas vertical e horizontal do mouse.

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 forem passados os parâmetros X e Y, este comando devolve os números de coluna e fila correspondentes às coordenadas do mouse, do contrário este comando devolve os números de coluna e fila de um clique ou de uma ação de seleção. O comando devolverá valores válidos mesmo quando a entrada de dados não esteja permitida na 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).
Em um list box hierárquico, o valor da coluna leva em consideração as colunas fusionadas para representar a hierarquia, como explicaod no parágrafo Gestão de seleções e de posições.

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

Quando os parâmetros X e Y não são utilizados, este comando só pode ser chamado no marco de um list box que gere um dos eventos abaixo:

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 Is nil pointer se for passado.

Ver também

LISTBOX GET CELL COORDINATES
LISTBOX SELECT BREAK