Mensagem WM_POINTERWHEEL

Postado na janela com foco de teclado em primeiro plano quando uma roda de rolagem é girada.

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

! [Importante]
Os aplicativos da área de trabalho devem estar cientes do DPI. Se o aplicativo não estiver ciente do DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas poderão parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não têm reconhecimento de DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte Escrevendo aplicativos Win32 de Alto DPI.

#define WM_POINTERWHEEL            0x024E

Parâmetros

wParam

Contém o identificador de ponteiro e o delta da roda. Use as macros a seguir para recuperar essas informações.

GET_POINTERID_WPARAM(wParam): identificador de ponteiro.

GET_WHEEL_DELTA_WPARAM(wParam): o delta da roda como um valor curto assinado.

lParam

Contém o local do ponto do ponteiro.

Observação

Como o ponteiro pode fazer contato com o dispositivo em uma área não trivial, esse local de ponto pode ser uma simplificação de uma área de ponteiro mais complexa. Sempre que possível, um aplicativo deve usar as informações completas da área do ponteiro em vez do local do ponto.

Use as macros a seguir para recuperar as coordenadas de tela física do ponto.

• GET_X_LPARAM(lParam): a coordenada x (ponto horizontal).
• GET_Y_LPARAM(lParam): a coordenada y (ponto vertical).

Retornar valor

Se o aplicativo processar essa mensagem, deve retornar zero.

Se o aplicativo não processar essa mensagem, ele deverá chamar DefWindowProc.

Comentários

Para recuperar as unidades de rolagem da roda, use o arquivo inputData da estrutura POINTER_INFO retornada chamando a função GetPointerInfo . Esse campo contém um valor assinado e é expresso em um múltiplo de WHEEL_DELTA. Um valor positivo indica uma rotação para frente e um valor negativo indica uma rotação para trás.

Observe que as entradas de roda podem ser entregues mesmo que o cursor do mouse esteja localizado fora da janela do aplicativo. As mensagens de roda são entregues de maneira muito semelhante às entradas do teclado. A janela de foco da fila de mensagens foregournd recebe as mensagens de roda.

Requisitos

Confira também

Mensagens