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
Fonctions d’espace de coordonnées et de transformation
Vue d’ensemble des espaces et transformations de coordonnées