MonitorFromPoint function

The MonitorFromPoint function retrieves a handle to the display monitor that contains a specified point.

Syntax


HMONITOR MonitorFromPoint(
  _In_  POINT pt,
  _In_  DWORD dwFlags
);

Parameters

pt [in]

A POINT structure that specifies the point of interest in virtual-screen coordinates.

dwFlags [in]

Determines the function's return value if the point is not contained within 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 point.

MONITOR_DEFAULTTONULL

Returns NULL.

MONITOR_DEFAULTTOPRIMARY

Returns a handle to the primary display monitor.

 

Return value

If the point is contained by a display monitor, the return value is an HMONITOR handle to that display monitor.

If the point is not contained by a display monitor, the return value depends on the value of dwFlags.

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
MonitorFromRect
MonitorFromWindow

 

 

Build date: 6/12/2013

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.