SetCursorPos, fonction (winuser.h)

Article
03/04/2024

Déplace le curseur vers les coordonnées d’écran spécifiées. Si les nouvelles coordonnées ne se trouvent pas dans le rectangle d’écran défini par l’appel de fonction ClipCursor le plus récent, le système ajuste automatiquement les coordonnées afin que le curseur reste dans le rectangle.

Syntaxe

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

Paramètres

[in] X

Type : int

Nouvelle coordonnée x du curseur, en coordonnées d’écran.

[in] Y

Type : int

Nouvelle coordonnée y du curseur, en coordonnées d’écran.

Valeur retournée

Type : BOOL

Retourne une valeur différente de zéro en cas de réussite ou de zéro dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le curseur est une ressource partagée. Une fenêtre doit déplacer le curseur uniquement lorsque le curseur se trouve dans la zone cliente de la fenêtre.

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

Le bureau d’entrée doit être le bureau actuel lorsque vous appelez SetCursorPos. Appelez OpenInputDesktop pour déterminer si le bureau actuel est le bureau d’entrée. Si ce n’est pas le cas, appelez SetThreadDesktop avec le HDESK retourné par OpenInputDesktop pour basculer vers ce bureau.

Exemples

Pour obtenir un exemple, consultez Utilisation du clavier pour déplacer le 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
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-2 (introduit dans Windows 10, version 10.0.10240)