GetCursorPos, fonction (winuser.h)

Article
03/04/2024

Récupère la position du curseur de la souris, dans les coordonnées de l’écran.

Syntaxe

BOOL GetCursorPos(
  [out] LPPOINT lpPoint
);

Paramètres

[out] lpPoint

Type : LPPOINT

Pointeur vers une structure POINT qui reçoit les coordonnées d’écran du curseur.

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

La position du curseur est toujours spécifiée dans les coordonnées de l’écran et n’est pas affectée par le mode de mappage de la fenêtre qui contient le curseur.

Le processus d’appel doit avoir WINSTA_READATTRIBUTES accès à la station de fenêtre.

Le bureau d’entrée doit être le bureau actuel lorsque vous appelez GetCursorPos. 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)