Функция ScreenToClient переделывает экранные координаты указанной точки на экране в координаты рабочей области.
Синтаксис
BOOL ScreenToClient( HWND hWnd, // дескриптор окна LPPOINT lpPoint // экранные координаты ); |
hWnd
[in] Дескриптор окна, рабочая область которого используется для преобразования.
lpPoint
[in] Указатель на структуру POINT, которая определяет переделываемые экранные координаты.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Чтобы вычислить координаты рабочей области, функция использует окно, идентифицированное параметром hWnd, и экранные координаты, данные в структуре POINT. Затем она заменяет экранные координаты координатами рабочей области. Новые координаты отсчитываются относительно левого верхнего угла рабочей области указанного окна.
Функция ScreenToClient предполагает, что указанная точка находится в экранных координатах.
Все координаты отсчитываются в единицах устройства.
Не используйте функцию ScreenToClient, когда находитесь в состоянии зеркального отражения, то есть, когда расположение слева направо изменилось в расположение справа налево. Вместо этого используйте функцию MapWindowPoints. Дополнительную информацию смотри в статье "Компоновка и зеркалирование окна" в разделе Функции окна.
Смотри также
Обзор Координатные пространства и преобразования, Функции, используемые координатными пространствами и преобразованиями, ClientToScreen, MapWindowPoints, POINT
|
Размещение и совместимость ScreenToClient |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 3.1 и старше |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows Server 2003 | Нет |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | User32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Winuser.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |