WM_POINTERWHEEL mensagem

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

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

! [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 High-DPIaplicativos 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.

Nota

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).

Valor de retorno

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

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

Observações

Para recuperar as unidades de rolagem da roda, use o inputData arquivado da estrutura de POINTER_INFO retornada chamando 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 do teclado. A janela de foco da fila de mensagens em primeiro plano recebe as mensagens de roda.

Requisitos

Consulte também

mensagens