MonitorFromWindow

  • Article

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

HMONITOR MonitorFromWindow(
  HWND hwnd,
  DWORD dwFlags
);

Parameters

  • hwnd
    [in] Handle to the window of interest.
  • dwFlags
    [in] DWORD that determines the return value of the function when the window 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 window.
    MONITOR_DEFAULTTONULL The return value is NULL.
    MONITOR_DEFAULTTOPRIMARY The return value is a handle to the primary screen.

Return Values

If the window 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 window. If the window does not intersect a screen, the return value depends on the value of dwFlags.

Remarks

If the window is currently minimized, this function uses the rectangle of the window before it was minimized.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

MonitorFromPoint | MonitorFromRect

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.