TrackMouseEvent 函式 (winuser.h)

發行項
08/28/2023

當滑鼠指標離開視窗或將滑鼠停留在視窗上，以指定的時間量張貼訊息。

注意如果_TrackMouseEvent函式存在，則呼叫TrackMouseEvent，否則_TrackMouseEvent模擬TrackMouseEvent。

語法

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

參數

[in, out] lpEventTrack

類型： LPTRACKMOUSEEVENT

包含追蹤資訊的 TRACKMOUSEEVENT 結構的指標。

傳回值

類型： BOOL

如果函式成功，則傳回值為非零。

如果函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

當滑鼠指標停留在指定的矩形期間內時，會將滑鼠指標視為暫留。呼叫 SystemParametersInfo。並使用 值SPI_GETMOUSEHOVERWIDTH、 SPI_GETMOUSEHOVERHEIGHT和 SPI_GETMOUSEHOVERTIME 來擷取矩形和時間的大小。

函式可以張貼下列訊息。

訊息	描述
WM_NCMOUSEHOVER	與 WM_MOUSEHOVER 相同的意義，但視窗的非client 區域除外。
WM_NCMOUSELEAVE	與 WM_MOUSELEAVE 相同的意義，但視窗的非工作區除外。
WM_MOUSEHOVER	滑鼠停留在視窗的工作區上，在呼叫 TrackMouseEvent之前所指定的時段內。產生此訊息時，暫留追蹤會停止。如果應用程式需要進一步追蹤滑鼠暫留行為，則必須再次呼叫 TrackMouseEvent 。
WM_MOUSELEAVE	在呼叫 TrackMouseEvent之前，將視窗的工作區留在滑鼠左方。當產生此訊息時， TrackMouseEvent 所要求的所有追蹤都會取消。如果滑鼠需要進一步追蹤滑鼠暫留行為，應用程式就必須在滑鼠重新輸入視窗時呼叫 TrackMouseEvent 。

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-mouse-l1-1-0 (在 Windows 8)