ScreenToClient, fonction (winuser.h)

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

Syntaxe

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

Paramètres

[in] hWnd

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

lpPoint

Pointeur vers une structure POINT qui spécifie les coordonnées d’écran à convertir.

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 utilise la fenêtre identifiée par le paramètre hWnd et les coordonnées d’écran fournies dans la structure POINT pour calculer les coordonnées du client. Il remplace ensuite les coordonnées de l’écran par les coordonnées du client. Les nouvelles coordonnées sont relatives à l’angle supérieur gauche de la zone cliente de la fenêtre spécifiée.

La fonction ScreenToClient suppose que le point spécifié est en coordonnées d’écran.

Toutes les coordonnées sont exprimées en unités d’appareil.

N’utilisez pas ScreenToClient dans une situation de mise en miroir, c’est-à-dire lors du passage d’une disposition de gauche à droite à une disposition de droite à droite. Utilisez plutôt MapWindowPoints. Pour plus d’informations, consultez « Disposition et mise en miroir des fenêtres » dans Fonctionnalités de la fenêtre.

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

ClientToScreen

Fonctions d’espace de coordonnées et de transformation

Vue d’ensemble des espaces et transformations de coordonnées

MapWindowPoints

POINT