MonitorFromWindow 函数 (winuser.h)

MonitorFromWindow 函数检索具有与指定窗口边界矩形交集面积最大的显示监视器的句柄。

语法

HMONITOR MonitorFromWindow(
  [in] HWND  hwnd,
  [in] DWORD dwFlags
);

参数

[in] hwnd

相关窗口的句柄。

[in] dwFlags

如果窗口不与任何显示监视器相交,则确定函数的返回值。

此参数的取值可为下列值之一:

含义
MONITOR_DEFAULTTONEAREST
返回最靠近窗口的显示监视器的句柄。
MONITOR_DEFAULTTONULL
返回 NULL
MONITOR_DEFAULTTOPRIMARY
返回主显示监视器的句柄。

返回值

如果窗口与一个或多个显示监视器矩形相交,则返回值为显示监视器的 HMONITOR 句柄,该句柄与窗口的交集面积最大。

如果窗口不与显示监视器相交,则返回值取决于 dwFlags 的值。

注解

如果窗口当前已最小化, 则 MonitorFromWindow 在最小化窗口之前会使用该窗口的矩形。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-ntuser-sysparams-ext-l1-1-1 ()

另请参阅

MonitorFromPoint

MonitorFromRect

多个显示监视器函数

多个显示监视器概述