Mensaje WM_POINTERHWHEEL

Artículo
06/03/2023

Publicado en la ventana con foco de teclado en primer plano cuando se gira una rueda de desplazamiento horizontal.

Una ventana recibe este mensaje a través de la función WindowProc.

Importante
Las aplicaciones de escritorio deben tener en cuenta ppp. Si la aplicación no es compatible con PPP, las coordenadas de pantalla contenidas en los mensajes de puntero y las estructuras relacionadas pueden parecer inexactas debido a la virtualización de PPP. La virtualización de PPP proporciona compatibilidad de escalado automático con aplicaciones que no son compatibles con PPP y están activas de forma predeterminada (los usuarios pueden desactivarla). Para obtener más información, vea Escribir aplicaciones Win32 de alto ppp.

#define WM_POINTERHWHEEL            0x024F

Parámetros

wParam

Contiene el identificador de puntero y el delta de la rueda. Use las macros siguientes para recuperar esta información.

GET_POINTERID_WPARAM(wParam): identificador de puntero.

GET_WHEEL_DELTA_WPARAM(wParam): delta de rueda como valor corto con signo.

lParam

Contiene la ubicación de punto del puntero.

Nota:

Dado que el puntero puede establecer contacto con el dispositivo sobre un área no trivial, esta ubicación de punto puede ser una simplificación de un área de puntero más compleja. Siempre que sea posible, una aplicación debe usar la información completa del área de puntero en lugar de la ubicación del punto.

Use las macros siguientes para recuperar las coordenadas de pantalla física del punto.

GET_X_LPARAM(lParam): coordenada x (punto horizontal).
GET_Y_LPARAM(lParam): coordenada y (punto vertical).

Valor devuelto

Si la aplicación procesa este mensaje, debe devolver cero.

Si la aplicación no procesa este mensaje, debe llamar a DefWindowProc.

Observaciones

Para recuperar las unidades de desplazamiento de la rueda, use el inputData archivado de la estructura POINTER_INFO devuelta llamando a la función GetPointerInfo . Este campo contiene un valor con signo y se expresa en un múltiplo de WHEEL_DELTA. Un valor positivo indica un giro hacia delante y un valor negativo indica un giro hacia atrás.

Tenga en cuenta que las entradas de la rueda se pueden entregar incluso si el cursor del mouse se encuentra fuera de la ventana de la aplicación. Los mensajes de rueda se entregan de forma muy similar a las entradas del teclado. La ventana de foco de la cola de mensajes anterior recibe los mensajes de rueda.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluya Windows.h)

Consulte también

Mensajes

Share via