TrackMouseEvent 関数 (winuser.h)

マウス ポインターがウィンドウの外に出るか、指定された時間だけウィンドウをポイントしていると、メッセージを投稿します。

メモ_TrackMouseEvent関数は、存在する場合は TrackMouseEvent を呼び出し、存在しない場合は TrackMouseEvent をエミュレート_TrackMouseEvent。

 

構文

BOOL TrackMouseEvent(
  [in, out] LPTRACKMOUSEEVENT lpEventTrack
);

パラメーター

[in, out] lpEventTrack

種類: LPTRACKMOUSEEVENT

追跡情報を含む TRACKMOUSEEVENT 構造体へのポインター。

戻り値

種類: BOOL

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

マウス ポインターは、指定した四角形内に一定の期間留まるときに、マウス ポインターがポイントしていると見なされます。 SystemParametersInfo を呼び出します。 SPI_GETMOUSEHOVERWIDTH、SPI_GETMOUSEHOVERHEIGHT、SPI_GETMOUSEHOVERTIMEの値を使用して、四角形のサイズと時刻を取得します。

関数は、次のメッセージを投稿できます。

Message	説明
WM_NCMOUSEHOVER	WM_MOUSEHOVER と同 じ意味ですが、これはウィンドウの非クライアント領域に対する意味です。
WM_NCMOUSELEAVE	WM_MOUSELEAVE と同 じ意味ですが、これはウィンドウの非クライアント領域に対する意味です。
WM_MOUSEHOVER	TrackMouseEvent の以前の呼び出しで指定された期間、ウィンドウのクライアント領域にマウス ポインターを置いた。 このメッセージが生成されると、ホバー追跡が停止します。 マウス ホバー動作をさらに追跡する必要がある場合は、アプリケーションで TrackMouseEvent をもう一度呼び出す必要があります。
WM_MOUSELEAVE	TrackMouseEvent の以前の呼び出しで指定されたウィンドウのクライアント領域をマウスで左に置きます。 このメッセージが生成されると、TrackMouseEvent によって要求されたすべての追跡は取り消されます。 マウスがそのウィンドウに再び入ってきたとき、アプリケーションでマウス ホバー動作をさらに追跡する必要がある場合は、TrackMouseEvent を呼び出す必要があります。

要件

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

関連項目

概念

マウス入力

その他のリソース

リファレンス

SystemParametersInfo

TRACKMOUSEEVENT

_TrackMouseEvent