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(
  _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.

ValueMeaning
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

See also

Multiple Display Monitors Overview
Multiple Display Monitors Functions
MonitorFromPoint
MonitorFromWindow

 

 

Build date: 6/12/2013

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.