Partager via


SetCursorPos, fonction (winuser.h)

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)

Voir aussi

ClipCursor

Conceptuel

Curseurs

GetCursorPos

Référence

SetCaretPos

SetCursor

ShowCursor