MonitorFromRect 函式 (winuser.h)

MonitorFromRect 函式會擷取顯示監視器的句柄，該監視器具有與指定矩形交集的最大區域。

語法

HMONITOR MonitorFromRect(
  [in] LPCRECT lprc,
  [in] DWORD   dwFlags
);

參數

[in] lprc

RECT 結構的指標，指定虛擬螢幕座標中感興趣的矩形。

[in] dwFlags

如果矩形未與任何顯示監視器交集，則判斷函式的傳回值。

此參數可以是下列其中一個值。

值	意義
MONITOR_DEFAULTTONEAREST	傳回最接近矩形之顯示監視器的句柄。
MONITOR_DEFAULTTONULL	傳回 NULL。
MONITOR_DEFAULTTOPRIMARY	傳回主要顯示監視器的句柄。

傳回值

如果矩形與一或多個顯示監視器矩形交集，則傳回值是顯示監視器的 HMONITOR 句柄，該監視器具有與矩形交集的最大區域。

如果矩形沒有與顯示監視器交集，則傳回值取決於 dwFlags 的值。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (於 Windows 10 10.0.14393 版中引進)

另請參閱

MonitorFromPoint

MonitorFromWindow

多個顯示監視器函式

多個顯示監視器概觀