WM_MOUSEHOVER メッセージ

以前の TrackMouseEvent の呼び出しで指定された期間にわたって、ウィンドウのクライアント領域の上にカーソルが置かれていたときにウィンドウに投稿されます。

ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。

#define WM_MOUSEHOVER                   0x02A1

パラメーター

wParam

さまざまな仮想キーが下がっているかどうかを示します。 このパラメーターには、次の値のいずれかを指定できます。

Value 意味
MK_CONTROL
0x0008
Ctrl キーが押されています。
MK_LBUTTON
0x0001
マウスの左ボタンが押されています。
MK_MBUTTON
0x0010
マウスの中央ボタンが押されています。
MK_RBUTTON
0x0002
マウスの右ボタンが押されています。
MK_SHIFT
0x0004
Shift キーが押されています。
MK_XBUTTON1
0x0020
最初の X ボタンが押されています。
MK_XBUTTON2
0x0040
2 つ目の X ボタンが押されています。

lParam

下位ワードは、カーソルの x 座標を指定します。 座標は、クライアント領域の左上隅を基準にしています。

上位ワードは、カーソルの y 座標を指定します。 座標は、クライアント領域の左上隅を基準にしています。

戻り値

アプリケーションでこのメッセージを処理する場合は、0 を返す必要があります。

解説

WM_MOUSEHOVER が生成されると、ホバー追跡が停止します。 マウス ホバー動作をさらに追跡する必要がある場合は、アプリケーションで TrackMouseEvent をもう一度呼び出す必要があります。

水平方向と垂直方向の位置を取得するには、次のコードを使用します。

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

前述のように、x 座標は戻り値の下位 short になり、y 座標は上位 short になります (複数のモニターを持つシステムでは負の値を取ることができるため、両方とも "符号付き" の値を表します)。 戻り値が変数に割り当てられている場合は、MAKEPOINTS マクロを使用して戻り値から POINTS 構造体を取得できます。 また、GET_X_LPARAM マクロまたは GET_Y_LPARAM マクロを使用して、x 座標または y 座標を抽出することもできます。

重要

LOWORD マクロまたは HIWORD マクロを使ってカーソル位置の x 座標と y 座標を抽出しないでください。これらのマクロは、複数のモニターを持つシステム上で正しくない結果を返します。 複数のモニターを持つシステムは負の x 座標と y 座標を持つ場合があり、LOWORDHIWORD は座標を符号なし数量として扱います。

要件

要件 Value
サポートされている最小のクライアント
Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Winuser.h (Windowsx.h を含む)

関連項目

リファレンス

GET_X_LPARAM

GET_Y_LPARAM

GetCapture

SetCapture

TrackMouseEvent

TRACKMOUSEEVENT

Conceptual

マウス入力

その他のリソース

MAKEPOINTS

POINTS