Função LBItemFromPt (commctrl.h)

Recupera o índice do item no ponto especificado em uma caixa de listagem.

Sintaxe

int LBItemFromPt(
  HWND  hLB,
  POINT pt,
  BOOL  bAutoScroll
);

Parâmetros

hLB

Tipo: HWND

Um identificador para a caixa de listagem para marcar.

pt

Tipo: POINT

Uma estrutura POINT que contém as coordenadas da tela para marcar.

bAutoScroll

Tipo: BOOL

Um sinalizador de rolagem. Se esse parâmetro for TRUE e o ponto estiver diretamente acima ou abaixo da caixa de listagem, a função rolará a caixa de listagem por uma linha e retornará -1. Caso contrário, a função não rolará a caixa de listagem.

Retornar valor

Tipo: int

Retorna o identificador de item se o ponto estiver sobre um item de lista ou -1 caso contrário.

Comentários

A função LBItemFromPt rola apenas a caixa de listagem se um tempo mínimo tiver passado desde a última vez que o fez. O tempo impede que a caixa de listagem role muito rapidamente se a função for chamada repetidamente em rápida sucessão, por exemplo, quando DL_DRAGGING códigos de notificação ou mensagens de WM_MOUSEMOVE são processadas.

Se o ponto especificado estiver fora da área do cliente da caixa de listagem e bAutoScroll for TRUE, a função rolará a caixa de listagem em vez de retornar um identificador de item.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h
Biblioteca	Comctl32.lib
DLL	Comctl32.dll