WM_POINTERWHEEL mensagem

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

Uma janela recebe esta mensagem através da sua função WindowProc.

! [Importante]
As aplicações de ambiente de trabalho devem estar cientes do DPI. Se seu aplicativo não reconhece DPI, as coordenadas de tela contidas em mensagens de ponteiro e estruturas relacionadas podem parecer imprecisas devido à virtualização de DPI. A virtualização de DPI fornece suporte de dimensionamento automático para aplicativos que não reconhecem DPI e estão ativos por padrão (os usuários podem desativá-lo). Para obter mais informações, consulte escrevendo High-DPI aplicativos Win32.

#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): 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, essa localização do 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 da localização do ponto.

Use as macros a seguir para recuperar as coordenadas físicas da tela do ponto.

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

Valor de retorno

Se o aplicativo processar essa mensagem, ele deve retornar zero.

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

Comentários

Para recuperar as unidades de rolagem de roda, use o inputData arquivado da estrutura POINTER_INFO retornada chamando função GetPointerInfo. Este campo contém um valor assinado e é expresso em um múltiplo de WHEEL_DELTA. Um valor positivo indica uma rotação para a 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 uma forma muito semelhante às entradas do teclado. A janela de foco da fila de mensagens anterior recebe as mensagens de roda.

Requerimentos

Ver também

Mensagens