SetCapture, fonction (winuser.h)
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) |
Voir aussi
Conceptuel
Référence