MonitorFromWindow 関数 (winuser.h)
MonitorFromWindow 関数は、指定したウィンドウの外接する四角形との交差領域が最も大きいディスプレイ モニターへのハンドルを取得します。
構文
HMONITOR MonitorFromWindow(
[in] HWND hwnd,
[in] DWORD dwFlags
);
パラメーター
[in] hwnd
目的のウィンドウへのハンドル。
[in] dwFlags
ウィンドウが表示モニターと交差しない場合に、関数の戻り値を決定します。
このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
ウィンドウに最も近いディスプレイ モニターへのハンドルを返します。 |
|
NULL を返します。 |
|
プライマリ ディスプレイ モニターへのハンドルを返します。 |
戻り値
ウィンドウが 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 で導入) |