Mensaje WM_MOUSEHWHEEL

Se envía a la ventana activa cuando se inclina o se rota la rueda del mouse horizontal. La función DefWindowProc propaga el mensaje al elemento primario de la ventana. No debe haber ningún reenvío interno del mensaje, ya que DefWindowProc lo propaga a la cadena primaria hasta que encuentra una ventana que lo procesa.

Una ventana recibe este mensaje mediante la función WindowProc.

#define WM_MOUSEHWHEEL                  0x020E

Parámetros

wParam

La palabra de primer orden indica la distancia que gira la rueda, expresada en múltiplos o factores de WHEEL_DELTA, que se establece en 120. Un valor positivo indica que la rueda se ha rotado hacia la derecha; un valor negativo indica que la rueda se ha rotado hacia la izquierda.

La palabra de orden inferior indica si hay varias teclas virtuales presionadas. Este parámetro puede ser uno o más de los siguientes valores.

Value	Significado
MK_CONTROL 0x0008	La tecla CTRL está presionada.
MK_LBUTTON 0x0001	El botón izquierdo del mouse está presionado.
MK_MBUTTON 0x0010	El botón central del mouse está presionado.
MK_RBUTTON 0x0002	El botón derecho del mouse está presionado.
MK_SHIFT 0x0004	La tecla MAYÚS está presionada.
MK_XBUTTON1 0x0020	El primer botón X está presionado.
MK_XBUTTON2 0x0040	El segundo botón X está pulsado.

lParam

La palabra de orden inferior especifica la coordenada x del puntero, relativa a la esquina superior izquierda de la pantalla.

La palabra de orden superior especifica la coordenada y del puntero, relativa a la esquina superior izquierda de la pantalla.

Valor devuelto

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

Comentarios

Use el código siguiente para obtener la información en el parámetro wParam.

fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);

Use el código siguiente para obtener la posición horizontal y vertical.

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

Tal como se indicó anteriormente, la coordenada X está en el valor short de orden inferior del valor devuelto; la coordenada Y está en el valor short de primer orden (ambos representan valores con signo porque pueden adoptar valores negativos en sistemas con varios monitores). Si el valor devuelto se asigna a una variable, puede usar la macro MAKEPOINTS para obtener una estructura POINTS a partir del valor devuelto. También puede usar las macros GET_X_LPARAM o GET_Y_LPARAM para extraer la coordenada X o Y.

Importante

No use las macros LOWORD ni HIWORD para extraer las coordenadas X e Y de la posición del cursor porque estas macros devuelven resultados incorrectos en sistemas con varios monitores. Los sistemas con varios monitores pueden tener coordenadas X e Y negativas, y LOWORD y HIWORD tratan las coordenadas como cantidades sin signo.

El giro de la rueda es un múltiplo de WHEEL_DELTA, que se establece en 120. Este es el umbral para que se realice una acción y una acción de este tipo (por ejemplo, desplazarse un incremento) se debe producir para cada delta.

El delta se estableció en 120 para permitir que Microsoft u otros proveedores creen ruedas de resolución más finas (por ejemplo, una rueda de rotación libre sin muescas) para enviar más mensajes por rotación, pero con un valor más pequeño en cada mensaje. Para usar esta característica, puede agregar los valores de delta entrantes hasta que se alcance WHEEL_DELTA (a fin de obtener la misma respuesta para una rotación diferencial), o bien desplácese por líneas parciales en respuesta a mensajes más frecuentes. También puede elegir una granularidad de desplazamiento y acumular deltas hasta que se alcance.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windowsx.h)

Consulte también

Referencia

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_Y_LPARAM

GET_WHEEL_DELTA_WPARAM

HIWORD

LOWORD

mouse_event

Conceptual

Entrada de mouse

Otros recursos

GetSystemMetrics

MAKEPOINTS

POINTS

SystemParametersInfo