Fonction ClipCursor (winuser.h)

Article
03/04/2024

Limite le curseur à une zone rectangulaire à l’écran. Si une position de curseur ultérieure (définie par la fonction SetCursorPos ou la souris) se trouve à l’extérieur du rectangle, le système ajuste automatiquement la position pour conserver le curseur à l’intérieur de la zone rectangulaire.

Syntaxe

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

Paramètres

[in, optional] lpRect

Type : const RECT*

Pointeur vers la structure qui contient les coordonnées de l’écran des coins supérieur gauche et inférieur droit du rectangle de confinement. Si ce paramètre a la valeur NULL, le curseur est libre de se déplacer n’importe où à l’écran.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le curseur est une ressource partagée. Si une application limite le curseur, elle doit relâcher le curseur à l’aide de ClipCursor avant de céder le contrôle à une autre application.

Le processus appelant doit avoir WINSTA_WRITEATTRIBUTES accès à la station de fenêtre.

Exemples

Pour obtenir un exemple, consultez Confisage d’un curseur.

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