Функция 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)

См. также раздел

ClientToScreen

Функции координатного пространства и преобразования

Общие сведения о координатных пространствах и преобразованиях

MapWindowPoints

ТОЧКИ