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

  • Статья

Функция MonitorFromWindow извлекает дескриптор на монитор дисплея, который имеет наибольшую область пересечения с ограничивающим прямоугольником указанного окна.

Синтаксис

HMONITOR MonitorFromWindow(
  [in] HWND  hwnd,
  [in] DWORD dwFlags
);

Параметры

[in] hwnd

Дескриптор интересующего окна.

[in] dwFlags

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

Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
MONITOR_DEFAULTTONEAREST
 Возвращает дескриптор монитора, ближайшего к окну.
MONITOR_DEFAULTTONULL
 Возвращает значение NULL.
MONITOR_DEFAULTTOPRIMARY
 Возвращает дескриптор основного монитора дисплея.

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

Если окно пересекается с одним или несколькими прямоугольниками монитора дисплея, возвращаемым значением будет дескриптор HMONITOR для монитора дисплея, имеющего самую большую область пересечения с окном.

Если окно не пересекается с монитором отображения, возвращаемое значение зависит от значения dwFlags.

Комментарии

Если окно в настоящее время свернуто, MonitorFromWindow использует прямоугольник окна перед свертыванием.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-sysparams-ext-l1-1-1 (представлено в Windows 10, версия 10.0.14393)

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

MonitorFromPoint

MonitorFromRect

Функции мониторов с несколькими дисплеями

Обзор мониторов с несколькими дисплеями