Поделиться через


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

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

Синтаксис

HMONITOR MonitorFromRect(
  [in] LPCRECT lprc,
  [in] DWORD   dwFlags
);

Параметры

[in] lprc

Указатель на структуру RECT , указывающую интересующий прямоугольник в координатах виртуального экрана.

[in] dwFlags

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

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

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

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

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

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

Требования

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

MonitorFromWindow

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

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