Entrée de la souris

Cette section décrit comment le système fournit une entrée de souris à votre application et comment l’application reçoit et traite cette entrée.

Dans cette section

Sujet	Description
à propos de la d’entrée de la souris	Cette rubrique traite de l’entrée de la souris.
à l’aide du d’entrée de la souris	Cette section traite des tâches associées à l’entrée de la souris.
référence d’entrée de la souris

Fonctions

Nom	Description
_TrackMouseEvent	Publie des messages lorsque le pointeur de la souris quitte une fenêtre ou pointe sur une fenêtre pendant une durée spécifiée. Cette fonction appelle TrackMouseEvent s’il existe, sinon il l’émule.
BlockInput	Bloque les événements d’entrée de clavier et de souris d’atteindre les applications.
DragDetect	Capture la souris et suit son mouvement jusqu’à ce que l’utilisateur relâche le bouton gauche, appuie sur la touche Échap ou déplace la souris en dehors du rectangle de glisser autour du point spécifié. La largeur et la hauteur du rectangle de glissement sont spécifiées par les valeurs SM_CXDRAG et SM_CYDRAG retournées par la fonctionGetSystemMetrics.
enableMouseInPointer	Permet à la souris d’agir en tant qu’appareil pointant.
enableWindow	Active ou désactive l’entrée de la souris et du clavier dans la fenêtre ou le contrôle spécifié. Lorsque l’entrée est désactivée, la fenêtre ne reçoit pas d’entrée telle que les clics de souris et les appuis sur les touches. Lorsque l’entrée est activée, la fenêtre reçoit toutes les entrées.
GetCapture	Récupère un handle dans la fenêtre (le cas échéant) qui a capturé la souris. Une seule fenêtre à la fois peut capturer la souris ; cette fenêtre reçoit l’entrée de la souris si le curseur se trouve à l’intérieur de ses bordures.
GetDoubleClickTime	Récupère l’heure actuelle du double-clic de la souris. Un double-clic est une série de deux clics du bouton de la souris, la seconde se produisant dans un délai spécifié après le premier. Le temps de double-clic est le nombre maximal de millisecondes qui peuvent se produire entre le premier et le deuxième clic d’un double-clic.
GetMouseMovePointsEx	Récupère un historique allant jusqu’à 64 coordonnées précédentes de la souris ou du stylet.
IsWindowEnabled	Détermine si la fenêtre spécifiée est activée pour l’entrée de la souris et du clavier.
ReleaseCapture	Libère la capture de la souris à partir d’une fenêtre dans le thread actuel et restaure le traitement normal des entrées de la souris. Une fenêtre qui a capturé la souris reçoit toutes les entrées de la souris, quelle que soit la position du curseur, sauf lorsqu’un bouton de la souris est cliqué pendant que le curseur se trouve dans la fenêtre d’un autre thread.
SendInput	Synthétise les séquences de touches, les mouvements de la souris et les clics de bouton.
setCapture	Définit la capture de la souris sur la fenêtre spécifiée appartenant au thread actuel. SetCapture capture l’entrée de la souris lorsque la souris se trouve sur la fenêtre de capture ou lorsque le bouton de la souris a été appuyé pendant que la souris était sur la fenêtre de capture et que le bouton est toujours enfoncé. Une seule fenêtre à la fois peut capturer la souris. Si le curseur de la souris se trouve sur une fenêtre créée par un autre thread, le système dirige l’entrée de la souris vers la fenêtre spécifiée uniquement si un bouton de souris est enfoncé.
SetDoubleClickTime	Définit l’heure du double-clic pour la souris. Un double-clic est une série de deux clics d’un bouton de souris, la seconde se produisant dans un délai spécifié après le premier. Le temps de double-clic est le nombre maximal de millisecondes qui peuvent se produire entre le premier et le deuxième clic d’un double-clic.
SwapMouseButton	Inverse ou restaure la signification des boutons gauche et droit de la souris.
TrackMouseEvent	Publie des messages lorsque le pointeur de la souris quitte une fenêtre ou pointe sur une fenêtre pendant une durée spécifiée.

La fonction suivante est obsolète.

Fonction	Description
mouse_event	Synthétise le mouvement de la souris et les clics de bouton.

Notifications

Nom	Description
WM_APPCOMMAND	Avertit une fenêtre que l’utilisateur a généré un événement de commande d’application, par exemple, en cliquant sur un bouton de commande d’application à l’aide de la souris ou en tapant une touche de commande d’application sur le clavier.
WM_CAPTURECHANGED	Envoyé à la fenêtre qui perd la capture de la souris.
WM_LBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur le bouton gauche de la souris 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.
WM_LBUTTONDOWN	Publié lorsque l’utilisateur appuie sur le bouton gauche de la souris 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.
WM_LBUTTONUP	Publié lorsque l’utilisateur relâche le bouton gauche de la souris 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.
WM_MBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur le bouton de la souris centrale 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.
WM_MBUTTONDOWN	Publié lorsque l’utilisateur appuie sur le bouton de la souris centrale 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.
WM_MBUTTONUP	Publié lorsque l’utilisateur libère le bouton de la souris centrale 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.
WM_MOUSEACTIVATE	Envoyé lorsque le curseur se trouve dans une fenêtre inactive et que l’utilisateur appuie sur un bouton de souris. La fenêtre parente reçoit ce message uniquement si la fenêtre enfant la transmet à la fonction DefWindowProc.
WM_MOUSEHOVER	Publié dans une fenêtre lorsque le curseur pointe sur la zone cliente de la fenêtre pendant la période spécifiée dans un appel antérieur à TrackMouseEvent.
WM_MOUSEHWHEEL	Envoyé à la fenêtre de focus lorsque la roulette de défilement horizontale de la souris est inclinée ou pivotée. La fonctionDefWindowProcpropage le message au parent de la fenêtre. Il ne doit pas y avoir de transfert interne du message, car DefWindowProc le propage jusqu’à ce qu’il trouve une fenêtre qui le traite.
WM_MOUSELEAVE	Publié dans une fenêtre lorsque le curseur quitte la zone cliente de la fenêtre spécifiée dans un appel antérieur à TrackMouseEvent.
WM_MOUSEMOVE	Publié dans une fenêtre lorsque le curseur se déplace. Si la souris n’est pas capturée, le message est publié dans la fenêtre qui contient le curseur. Sinon, le message est publié dans la fenêtre qui a capturé la souris.
WM_MOUSEWHEEL	Envoyé à la fenêtre de focus lorsque la roulette de la souris est pivotée. La fonction DefWindowProc propage le message au parent de la fenêtre. Il ne doit pas y avoir de transfert interne du message, car DefWindowProc le propage jusqu’à ce qu’il trouve une fenêtre qui le traite.
WM_NCHITTEST	Envoyé à une fenêtre pour déterminer quelle partie de la fenêtre correspond à une coordonnée d’écran particulière. Cela peut se produire, par exemple, lorsque le curseur se déplace, lorsqu’un bouton de la souris est enfoncé ou relâché, ou en réponse à un appel à une fonction telle que WindowFromPoint. Si la souris n’est pas capturée, le message est envoyé à la fenêtre sous le curseur. Sinon, le message est envoyé à la fenêtre qui a capturé la souris.
WM_NCLBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur le bouton gauche de la souris pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCLBUTTONDOWN	Publié lorsque l’utilisateur appuie sur le bouton gauche de la souris pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCLBUTTONUP	Publié lorsque l’utilisateur relâche le bouton gauche de la souris pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCMBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur le bouton de la souris centrale pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCMBUTTONDOWN	Publié lorsque l’utilisateur appuie sur le bouton de la souris centrale pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCMBUTTONUP	Publié lorsque l’utilisateur libère le bouton de la souris centrale pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCMOUSEHOVER	Publié dans une fenêtre lorsque le curseur pointe sur la zone non cliente de la fenêtre pendant la période spécifiée dans un appel antérieur àTrackMouseEvent.
WM_NCMOUSELEAVE	Publié dans une fenêtre lorsque le curseur quitte la zone non cliente de la fenêtre spécifiée dans un appel antérieur àTrackMouseEvent.
WM_NCMOUSEMOVE	Publié dans une fenêtre lorsque le curseur est déplacé dans la zone non cliente de la fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCRBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur le bouton droit de la souris pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCRBUTTONDOWN	Publié lorsque l’utilisateur appuie sur le bouton droit de la souris pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCRBUTTONUP	Publié lorsque l’utilisateur libère le bouton droit de la souris pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCXBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur XBUTTON1 ou XBUTTON2 pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCXBUTTONDOWN	Publié lorsque l’utilisateur appuie sur XBUTTON1 ou XBUTTON2 pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_NCXBUTTONUP	Publié lorsque l’utilisateur publie XBUTTON1 ou XBUTTON2 pendant que le curseur se trouve dans la zone non cliente d’une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.
WM_RBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique sur le bouton droit de la souris 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.
WM_RBUTTONDOWN	Publié lorsque l’utilisateur appuie sur le bouton droit de la souris 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.
WM_RBUTTONUP	Publié lorsque l’utilisateur libère le bouton droit de la souris 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.
WM_XBUTTONDBLCLK	Publié lorsque l’utilisateur double-clique 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.
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.
WM_XBUTTONUP	Publié lorsque l’utilisateur publie 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.

Structures

Nom	Description
HARDWAREINPUT	Contient des informations sur un message simulé généré par un appareil d’entrée autre qu’un clavier ou une souris.
INPUT	Contient des informations utilisées pour synthétiser les événements d’entrée tels que les séquences de touches, le mouvement de la souris et les clics de souris.
LASTINPUTINFO	Contient l’heure de la dernière entrée.
MOUSEINPUT	Contient des informations sur un événement de souris simulé.
MOUSEMOVEPOINT	Contient des informations sur l’emplacement de la souris dans les coordonnées de l’écran.
TRACKMOUSEEVENT	Utilisé par la fonction TrackMouseEvent pour effectuer le suivi lorsque le pointeur de la souris quitte une fenêtre ou pointe sur une fenêtre pendant une durée spécifiée.