Функция ScreenToClient

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

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz