Функция ClientToScreen (winuser.h)

Статья
08/27/2023

Функция ClientToScreen преобразует координаты клиентской области указанной точки в экранные координаты.

Синтаксис

BOOL ClientToScreen(
  [in]      HWND    hWnd,
  [in, out] LPPOINT lpPoint
);

Параметры

[in] hWnd

Дескриптор для окна, клиентская область которого используется для преобразования.

[in, out] lpPoint

Указатель на структуру POINT , содержащую координаты клиента для преобразования. Новые экранные координаты копируются в эту структуру при успешном выполнении функции.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Функция ClientToScreen заменяет координаты клиентской области в структуре POINT координатами экрана. Координаты экрана находятся относительно левого верхнего угла экрана. Обратите внимание, что точка экранной координаты, расположенная над клиентской областью окна, имеет отрицательную координату по оси Y. Аналогичным образом координата экрана слева от клиентской области имеет отрицательную координату X.

Все координаты являются координатами устройства.

Примеры

Пример см. в разделе Рисование линий с помощью мыши в разделе Использование ввода мыши.

Требования

Требование	Значение
Минимальная версия клиента	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)