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

Статья
08/27/2023

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

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

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

Share via