Share via

MonitorFromRect

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves a handle to the screen that has the largest area of intersection with a specified rectangle.

Syntax

HMONITOR MonitorFromRect(
  LPCRECT lprc,
  DWORD dwFlags
);

Parameters

  • lprc
    [in] Pointer to a RECT structure that specifies the coordinates of the rectangle of interest in virtual screen coordinates.

  • dwFlags
    [in] DWORD that determines the return value of the function when the rectangle does not intersect any of the screens. The following table shows a list of possible return values.

    Value Description

    MONITOR_DEFAULTTONEAREST

    The return value is a handle to the screen that is nearest to the rectangle.

    MONITOR_DEFAULTTONULL

    The return value is NULL.

    MONITOR_DEFAULTTOPRIMARY

    The return value is a handle to the primary screen.

Return Value

If the rectangle intersects one or more screen rectangles, the return value is an HMONITOR handle to the screen that has the largest area of intersection with the rectangle. If the rectangle does not intersect a screen, the return value depends on the value of dwFlags.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

MonitorFromPoint
MonitorFromWindow

Other Resources

RECT