message WM_XBUTTONDOWN
Publié lorsque l’utilisateur appuie sur XBUTTON1 ou XBUTTON2 pendant que le curseur se trouve dans la zone cliente d’une fenêtre. Si la souris n’est pas capturée, le message est publié dans la fenêtre sous le curseur. Sinon, le message est publié dans la fenêtre qui a capturé la souris.
Une fenêtre reçoit ce message via sa fonction WindowProc.
#define WM_XBUTTONDOWN 0x020B
Paramètres
-
wParam
-
Le mot de bas ordre indique si différentes clés virtuelles sont en panne. Il peut s’agir d’une ou plusieurs des valeurs suivantes.
Valeur Signification - MK_CONTROL
- 0x0008
La touche Ctrl est enfoncée. - MK_LBUTTON
- 0x0001
Le bouton gauche de la souris est enfoncé. - MK_MBUTTON
- 0x0010
Le bouton central de la souris est enfoncé. - MK_RBUTTON
- 0x0002
Le bouton droit de la souris est enfoncé. - MK_SHIFT
- 0x0004
La touche Maj est en panne. - MK_XBUTTON1
- 0x0020
La XBUTTON1 est en panne. - MK_XBUTTON2
- 0x0040
La XBUTTON2 est en panne. Le mot à ordre élevé indique le bouton sur lequel le bouton a été cliqué. Il peut s’agir de l’une des valeurs suivantes.
Valeur Signification - XBUTTON1
- 0x0001
Le XBUTTON1 a été cliqué. - XBUTTON2
- 0x0002
Le XBUTTON2 a été cliqué. -
lParam
-
Le mot de bas ordre spécifie la coordonnée x du curseur. La coordonnée est relative au coin supérieur gauche de la zone cliente.
Le mot à ordre élevé spécifie la coordonnée y du curseur. La coordonnée est relative au coin supérieur gauche de la zone cliente.
Valeur de retour
Si une application traite ce message, elle doit retourner TRUE. Pour plus d’informations sur le traitement de la valeur de retour, consultez la section Remarques.
Remarques
Windows prend en charge les souris avec jusqu’à cinq boutons : gauche, milieu et droit, ainsi que deux boutons supplémentaires appelés XBUTTON1 et XBUTTON2. Les boutons XBUTTON1 et XBUTTON2 sont souvent situés sur les côtés de la souris, près de la base. Ces boutons supplémentaires ne sont pas présents sur toutes les souris. S’il est présent, les boutons XBUTTON1 et XBUTTON2 sont souvent mappés à une fonction d’application, comme la navigation vers l’avant et l’arrière dans un navigateur Web.
Utilisez le code suivant pour obtenir les informations dans le paramètre wParam :
fwKeys = GET_KEYSTATE_WPARAM (wParam);
fwButton = GET_XBUTTON_WPARAM (wParam);
Utilisez le code suivant pour obtenir la position horizontale et verticale :
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Comme indiqué ci-dessus, la coordonnée x se trouve dans le court de la valeur de retour ; la coordonnée y se trouve dans l’ordre élevé courte (les deux représentent valeurs signées, car elles peuvent prendre des valeurs négatives sur les systèmes avec plusieurs moniteurs). Si la valeur de retour est affectée à une variable, vous pouvez utiliser la macro MAKEPOINTS pour obtenir une structure POINTS à partir de la valeur de retour. Vous pouvez également utiliser la macro GET_X_LPARAM ou GET_Y_LPARAM pour extraire la coordonnée x ou y.
Important
N’utilisez pas les LOWORD
Contrairement aux messages WM_LBUTTONDOWN, WM_MBUTTONDOWNet WM_RBUTTONDOWN, une application doit retourner TRUE à partir de ce message s’il le traite. Cela permet aux logiciels qui simulent ce message sur les systèmes Windows antérieurs à Windows 2000 de déterminer si la procédure de fenêtre a traité le message ou appelé DefWindowProc pour le traiter.
Exigences
| Exigence | Valeur |
|---|---|
| Client minimum pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimum pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|
Voir aussi
-
de référence
-
conceptuelle
-
autres ressources