This topic has not yet been rated - Rate this topic

MonitorFromRect function

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

Syntax

C++


HMONITOR MonitorFromRect(
  _In_  LPCRECT lprc,
  _In_  DWORD dwFlags
);

Parameters

lprc [in]

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

dwFlags [in]

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.

Examples

For an example, see Positioning Objects on a Multiple Display Setup.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll

Community Additions

ADD