SetCapture, fonction (winuser.h)

Article
08/28/2023

Définit la capture de la souris sur la fenêtre spécifiée appartenant au thread en cours. SetCapture capture l’entrée de la souris soit lorsque la souris se trouve au-dessus de la fenêtre de capture, soit lorsque le bouton de la souris a été enfoncé alors que la souris se trouvait au-dessus de 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 au-dessus d’une fenêtre créée par un autre thread, le système dirigera l’entrée de la souris vers la fenêtre spécifiée uniquement si un bouton de la souris est enfoncé.

Syntaxe

HWND SetCapture(
  [in] HWND hWnd
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre dans le thread actuel qui doit capturer la souris.

Valeur retournée

Type : HWND

La valeur de retour est un handle de la fenêtre qui avait précédemment capturé la souris. S’il n’existe aucune fenêtre de ce type, la valeur de retour est NULL.

Remarques

Seule la fenêtre de premier plan peut capturer la souris. Lorsqu’une fenêtre d’arrière-plan tente de le faire, la fenêtre reçoit des messages uniquement pour les événements de souris qui se produisent lorsque le point chaud du curseur se trouve dans la partie visible de la fenêtre. En outre, même si la fenêtre de premier plan a capturé la souris, l’utilisateur peut toujours cliquer sur une autre fenêtre, la ramenant au premier plan.

Lorsque la fenêtre ne nécessite plus toutes les entrées de la souris, le thread qui a créé la fenêtre doit appeler la fonction ReleaseCapture pour libérer la souris.

Cette fonction ne peut pas être utilisée pour capturer une entrée de souris destinée à un autre processus.

Lorsque la souris est capturée, les touches d’accès rapide de menu et les autres raccourcis clavier ne fonctionnent pas.

Exemples

Pour obtenir un exemple, consultez Dessin de lignes avec la souris.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-mouse-l1-1-0 (introduit dans Windows 8)