WM_MOUSEWHEEL (mensaje)
Se envía a la ventana que tiene el foco cuando se gira la rueda del mouse. 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_MOUSEWHEEL 0x020A
Parámetros
-
wParam
-
La palabra de orden superior indica la distancia que se gira la rueda, expresada en múltiplos o fracciones de WHEEL_DELTA, que es 120. Un valor positivo indica que la rueda se ha girado hacia delante, hacia el lado contrario al usuario. Un valor negativo indica que la rueda se ha girado hacia atrás, hacia el usuario.
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
Utilice el siguiente código para obtener la información del parámetro wParam:
fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);
Utilice el siguiente código para obtener la posición horizontal y vertical:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Como se indicó anteriormente, la coordenada X está en el entero short de orden inferior del valor devuelto; la coordenada Y está en el entero short de orden superior (ambos representan valores con signo porque pueden tomar 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 será un múltiplo de WHEEL_DELTA, que está establecido en 120. Este valor es el umbral para que se realice una acción. Debe producirse una acción de este tipo (por ejemplo, desplazarse un incremento) por cada delta.
El delta se estableció en 120 para permitir a Microsoft y otros proveedores crear ruedas con una resolución más fina (una rueda que gira libremente sin muescas) con el fin de enviar más mensajes por giro, pero con un valor más pequeño en cada mensaje. Para usar esta característica, puede agregar los valores delta entrantes hasta que se alcance WHEEL_DELTA (de modo que obtiene la misma respuesta para un giro delta), o bien desplazar 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.
Tenga en cuenta que no hay fwKeys para MSH_MOUSEWHEEL. De lo contrario, los parámetros son exactamente los mismos que para WM_MOUSEWHEEL.
Es la aplicación la que debe reenviar MSH_MOUSEWHEEL a los objetos o controles insertados. La aplicación debe enviar el mensaje a una aplicación OLE insertada activa. Es opcional que la aplicación se lo envíe a un control habilitado para rueda con el foco. Si la aplicación envía el mensaje a un control, puede comprobar el valor devuelto para saber si se ha procesado el mensaje. Los controles deben devolver el valor TRUE si procesan el mensaje.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
Encabezado |
|
Consulte también
-
Referencia
-
Conceptual
-
Otros recursos