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
Conceptuel
Référence