Функция ScreenToClient (winuser.h)
Функция ScreenToClient преобразует экранные координаты указанной точки на экране в координаты клиентской области.
Синтаксис
BOOL ScreenToClient(
[in] HWND hWnd,
LPPOINT lpPoint
);
Параметры
[in] hWnd
Дескриптор окна, клиентская область которого будет использоваться для преобразования.
lpPoint
Указатель на структуру POINT , указывающую координаты экрана для преобразования.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Функция использует окно, определенное параметром hWnd , и экранные координаты, заданные в структуре POINT , для вычисления координат клиента. Затем он заменяет экранные координаты клиентскими координатами. Новые координаты находятся относительно левого верхнего угла клиентской области указанного окна.
Функция ScreenToClient предполагает, что указанная точка находится в экранных координатах.
Все координаты находятся в единицах устройства.
Не используйте ScreenToClient при зеркальном отображении, то есть при переходе с макета слева направо на макет справа налево. Вместо этого используйте MapWindowPoints. Дополнительные сведения см. в разделе "Макет окна и зеркальное отображение" статьи Функции окна.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | winuser.h (включая Windows.h) |
Библиотека | User32.lib |
DLL | User32.dll |
Набор API | ext-ms-win-ntuser-window-l1-1-2 (представлено в Windows 10 версии 10.0.10240) |
См. также раздел
Функции координатного пространства и преобразования
Общие сведения о координатных пространствах и преобразованиях