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 で導入)

関連項目

MonitorFromPoint

MonitorFromRect

複数ディスプレイモニター機能

複数ディスプレイ モニターの概要