MonitorFromRect 関数 (winuser.h)

MonitorFromRect 関数は、指定した四角形との交差領域が最も大きいディスプレイモニターへのハンドルを取得します。

構文

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

[in] lprc

仮想画面座標で目的の四角形を指定する RECT 構造体へのポインター。

[in] dwFlags

四角形がディスプレイモニターと交差しない場合に、関数の戻り値を決定します。

このパラメーターには、次の値のいずれかを指定できます。

値	意味
MONITOR_DEFAULTTONEAREST	四角形に最も近いディスプレイモニターへのハンドルを返します。
MONITOR_DEFAULTTONULL	NULL を返します。
MONITOR_DEFAULTTOPRIMARY	プライマリディスプレイモニターへのハンドルを返します。

四角形が 1 つ以上のディスプレイモニターの四角形と交差する場合、戻り値は、四角形との交差領域が最も大きいディスプレイモニターへの HMONITOR ハンドルです。

四角形がディスプレイモニターと交差しない場合、戻り値は dwFlags の値によって異なります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)