Fonction ClientToScreen (winuser.h)

Article
03/13/2024

La fonction ClientToScreen convertit les coordonnées de zone client d’un point spécifié en coordonnées d’écran.

Syntaxe

BOOL ClientToScreen(
  [in]      HWND    hWnd,
  [in, out] LPPOINT lpPoint
);

Paramètres

[in] hWnd

Handle vers la fenêtre dont la zone cliente est utilisée pour la conversion.

[in, out] lpPoint

Pointeur vers une structure POINT qui contient les coordonnées du client à convertir. Les nouvelles coordonnées d’écran sont copiées dans cette structure si la fonction réussit.

Valeur retournée

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.

Remarques

La fonction ClientToScreen remplace les coordonnées de la zone client dans la structure POINT par les coordonnées de l’écran. Les coordonnées de l’écran sont relatives à l’angle supérieur gauche de l’écran. Notez qu’un point de coordonnées d’écran qui se trouve au-dessus de la zone cliente de la fenêtre a une coordonnée y négative. De même, une coordonnée d’écran à gauche d’une zone cliente a une coordonnée x négative.

Toutes les coordonnées sont des coordonnées d’appareil.

Exemples

Pour obtenir un exemple, consultez « Dessin de lignes avec la souris » dans Utilisation de l’entrée de la souris.

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)