Mensagem WM_POINTERHWHEEL

Postado na janela com foco de teclado em primeiro plano quando uma roda de rolagem horizontal é 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_POINTERHWHEEL            0x024F

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): delta da roda como 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ísicas 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 de roda, use o inputData arquivado da estrutura POINTER_INFO retornada chamando a função GetPointerInfo . Esse campo contém um valor assinado e é expresso em vários 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 se o cursor do mouse estiver localizado fora da janela do aplicativo. As mensagens de roda são entregues de forma muito semelhante às entradas de teclado. A janela de foco da fila de mensagens foregournd recebe as mensagens de roda.

Requisitos

Confira também

Mensagens