WM_MOUSEHWHEEL mensagem
Enviado para a janela ativa quando a roda de rolagem horizontal do mouse é inclinada ou girada. A função DefWindowProc propaga a mensagem para o pai da janela. Não deve haver encaminhamento interno da mensagem, uma vez que DefWindowProc a propaga pela cadeia pai até encontrar uma janela que a processe.
Uma janela recebe esta mensagem através da sua função WindowProc.
#define WM_MOUSEHWHEEL 0x020E
Parâmetros
-
wParam
-
A palavra de ordem alta indica a distância que a roda é girada, expressa em múltiplos ou fatores de WHEEL_DELTA, que é definida como 120. Um valor positivo indica que a roda foi girada para a direita; Um valor negativo indica que a roda foi girada para a esquerda.
A palavra de ordem baixa indica se várias chaves virtuais estão inativas. Este parâmetro pode ser um ou mais dos seguintes valores.
Valor Significado - MK_CONTROL
- 0x0008
A tecla CTRL está inativa. - MK_LBUTTON
- 0x0001
O botão esquerdo do rato está inativo. - MK_MBUTTON
- 0x0010
O botão do meio do mouse está para baixo. - MK_RBUTTON
- 0x0002
O botão direito do rato está inativo. - MK_SHIFT
- 0x0004
A tecla SHIFT está inativa. - MK_XBUTTON1
- 0x0020
O XBUTTON1 está em baixa. - MK_XBUTTON2
- 0x0040
A XBUTTON2 está em baixa. -
lParam
-
A palavra de ordem baixa especifica a coordenada x do ponteiro, em relação ao canto superior esquerdo da tela.
A palavra de ordem alta especifica a coordenada y do ponteiro, em relação ao canto superior esquerdo da tela.
Valor de retorno
Se um aplicativo processar essa mensagem, ele deverá retornar zero.
Comentários
Use o código a seguir para obter as informações no parâmetro wParam
fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);
Use o código a seguir para obter a posição horizontal e vertical.
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Como observado acima, a coordenada x está na ordem baixa
Importante
Não use o LOWORD ou macros 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.
A rotação da roda é um múltiplo de WHEEL_DELTA, que é definido como 120. Este é o limite para a ação a ser tomada, e uma dessas ações (por exemplo, rolar um incremento) deve ocorrer para cada delta.
O delta foi definido como 120 para permitir que a Microsoft ou outros fornecedores construíssem rodas de resolução mais fina (por exemplo, uma roda de rotação livre sem entalhes) para enviar mais mensagens por rotação, mas com um valor menor em cada mensagem. Para usar esse recurso, você pode adicionar os valores delta de entrada até que WHEEL_DELTA seja atingido (para uma rotação delta você obtenha a mesma resposta) ou rolar linhas parciais em resposta a mensagens mais frequentes. Você também pode escolher sua granularidade de rolagem e acumular deltas até que ela seja atingida.
Requerimentos
| Exigência | Valor |
|---|---|
| Cliente mínimo suportado |
Windows Vista [apenas aplicações de ambiente de trabalho] |
| Servidor mínimo suportado |
Windows Server 2008 [apenas aplicações de ambiente de trabalho] |
| Cabeçalho |
|
Ver também
-
de referência
-
Conceptual
-
Outros recursos