Share via

Gdi::MonitorFromWindow_I (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

Syntax

static HMONITOR WINAPI MonitorFromWindow_I(
  HWND hwnd,
  DWORD dwFlag
);

Parameters

  • hwnd
    [in] Handle to the window of interest.

  • dwFlag
    [in] DWORD that determines the return value of the method when the window does not intersect any screen.

    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 Value

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 dwFlag.

Remarks

This method is an internal version of the MonitorFromWindow function.

If the window is minimized, Gdi::MonitorFromWindow_I uses the rectangle of the window before it was minimized.

Requirements

Header gdi.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Gdi
Gdi::MonitorFromPoint_I
Gdi::MonitorFromRect_I

Other Resources

MonitorFromWindow