Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

 

 

Community Additions

Show:
© 2014 Microsoft