MonitorFromRect function

The MonitorFromRect function retrieves a handle to the display monitor that has the largest area of intersection with a specified rectangle.

Syntax

HMONITOR MonitorFromRect(
  LPCRECT lprc,
  DWORD   dwFlags
);

Parameters

lprc

A pointer to a RECT structure that specifies the rectangle of interest in virtual-screen coordinates.

dwFlags

Determines the function's return value if the rectangle does not intersect any display monitor.

This parameter can be one of the following values.

Value Meaning
MONITOR_DEFAULTTONEAREST
Returns a handle to the display monitor that is nearest to the rectangle.
MONITOR_DEFAULTTONULL
Returns NULL.
MONITOR_DEFAULTTOPRIMARY
Returns a handle to the primary display monitor.

Return Value

If the rectangle intersects one or more display monitor rectangles, the return value is an HMONITOR handle to the display monitor that has the largest area of intersection with the rectangle.

If the rectangle does not intersect a display monitor, the return value depends on the value of dwFlags.

Requirements

   
Windows version Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll

See Also

MonitorFromPoint

MonitorFromWindow

Multiple Display Monitors Functions

Multiple Display Monitors Overview