LISTBOX GET CELL POSITION
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 | any | → | Nome objeto (se * for especificado) ou Variável (se * é omitido) |
| X | Real | → | Horizontal coordinate of mouse |
| Y | Real | → | Vertical coordinate of mouse |
| coluna | Integer | ← | Número de coluna |
| linha | Integer | ← | Número da fila |
| varCol | Pointer | ← | Ponteiro para a variável coluna |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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.