MonitorFromWindow 関数 (winuser.h)

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

構文

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

[in] hwnd

目的のウィンドウへのハンドル。

[in] dwFlags

ウィンドウが表示モニターと交差しない場合に、関数の戻り値を決定します。

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

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

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

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

ウィンドウが現在最小化されている場合、 MonitorFromWindow は最小化される前にウィンドウの四角形を使用します。


サポートされている最小のクライアント	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 で導入)