Функция 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 | Нет | |
Замечания по платформе | Не имеется |