Mensaje de WM_XBUTTONDOWN

Publicado cuando el usuario presiona el primer o segundo botón X mientras el cursor está en el área cliente de una ventana. Si no se captura el mouse, se envía el mensaje a la ventana debajo del cursor. De lo contrario, el mensaje se publica en la ventana que ha capturado el mouse.

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

#define WM_XBUTTONDOWN                  0x020B

Parámetros

wParam

La palabra de orden inferior indica si hay varias teclas virtuales presionadas. Este puede ser uno o varios 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.

La palabra de orden superior indica en qué botón se hizo clic. Puede ser uno de los siguientes valores.

Value	Significado
XBUTTON1 0x0001	Se hizo clic en el primer botón X.
XBUTTON2 0x0002	Se hizo clic en el segundo botón X.

lParam

La palabra de orden inferior especifica la coordenada X del cursor. La coordenada es relativa a la esquina superior izquierda del área cliente.

La palabra de primer orden especifica la coordenada Y del cursor. La coordenada es relativa a la esquina superior izquierda del área cliente.

Valor devuelto

Si la aplicación procesa este mensaje, debería devolver TRUE. Para más información sobre cómo procesar el valor devuelto, consulte la sección Comentarios.

Comentarios

Utilice el siguiente código para obtener la información del parámetro wParam:

fwKeys = GET_KEYSTATE_WPARAM (wParam); 
fwButton = GET_XBUTTON_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.

A diferencia de los mensajes WM_LBUTTONDOWN, WM_MBUTTONDOWN y WM_RBUTTONDOWN, una aplicación debe devolver TRUE a partir de este mensaje si se procesa. Al hacerlo, el software que simula este mensaje en sistemas de Windows anteriores a Windows 2000 para determinar si el procedimiento de ventana procesó el mensaje o llamó a DefWindowProc para procesarlo.

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	Winuser.h (incluye Windowsx.h)

Consulte también

Referencia

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_XBUTTON_WPARAM

GET_Y_LPARAM

GetCapture

SetCapture

WM_XBUTTONDBLCLK

WM_XBUTTONUP

Conceptual

Entrada de mouse

Otros recursos

MAKEPOINTS

POINTS