Compartilhar via


WM_MOUSEHOVER mensagem

Postado em uma janela quando o cursor passa o mouse sobre a área do cliente da janela pelo período de tempo especificado em uma chamada anterior para TrackMouseEvent.

Uma janela recebe essa mensagem por meio de sua função WindowProc.

#define WM_MOUSEHOVER                   0x02A1

Parâmetros

wParam

Indica se várias chaves virtuais estão inoperantes. Esse parâmetro pode ser um ou mais dos valores a seguir.

Valor Significado
MK_CONTROL
0x0008
A tecla CTRL está deprimida.
MK_LBUTTON
0x0001
O botão esquerdo do mouse está deprimido.
MK_MBUTTON
0x0010
O botão do mouse do meio está deprimido.
MK_RBUTTON
0x0002
O botão direito do mouse está deprimido.
MK_SHIFT
0x0004
A chave SHIFT está deprimida.
MK_XBUTTON1
0x0020
O XBUTTON1 está inoperante.
MK_XBUTTON2
0x0040
O XBUTTON2 está inoperante.

lParam

A palavra de baixa ordem especifica a coordenada x do cursor. A coordenada é relativa ao canto superior esquerdo da área do cliente.

A palavra de alta ordem especifica a coordenada y do cursor. A coordenada é relativa ao canto superior esquerdo da área do cliente.

Valor de retorno

Se um aplicativo processar essa mensagem, ela deverá retornar zero.

Observações

O controle de foco para quando WM_MOUSEHOVER é gerado. O aplicativo deve chamar TrackMouseEvent novamente se exigir um acompanhamento adicional do comportamento do mouse hover.

Use o seguinte código para obter a posição horizontal e vertical:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Conforme observado acima, a coordenada x está na ordem inferior curto do valor retornado; a coordenada y está na curta (ambas representam valores assinados porque podem levar valores negativos em sistemas com vários monitores). Se o valor retornado for atribuído a uma variável, você poderá usar a macro MAKEPOINTS para obter uma estrutura POINTS do valor retornado. Você também pode usar a macro GET_X_LPARAM ou GET_Y_LPARAM para extrair a coordenada x ou y.

Importante

Não use as macros loword ou HIWORD para extrair as coordenadas x e y da posição do cursor porque essas macros retornam resultados incorretos em sistemas com vários monitores. Sistemas com vários monitores podem ter coordenadas x e y negativas e LOWORD e HIWORD tratar as coordenadas como quantidades não assinadas.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windowsx.h)

Consulte também

de referência de

GET_X_LPARAM

GET_Y_LPARAM

GetCapture

SetCapture

TrackMouseEvent

TRACKMOUSEEVENT

Conceitual

de entrada do mouse

outros recursos

MAKEPOINTS

POINTS