共用方式為


TRACKMOUSEEVENT 結構 (winuser.h)

TrackMouseEvent 函式用來追蹤滑鼠指標離開視窗的時間,或將滑鼠停留在視窗上的指定時間量。

語法

typedef struct tagTRACKMOUSEEVENT {
  DWORD cbSize;
  DWORD dwFlags;
  HWND  hwndTrack;
  DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;

成員

cbSize

類型: DWORD

TRACKMOUSEEVENT 結構的大小,以位元組為單位。

dwFlags

類型: DWORD

所要求的服務。 這個成員可以是下列值的組合。

意義
TME_CANCEL
0x80000000
呼叫端想要取消先前的追蹤要求。 呼叫端也應該指定想要取消的追蹤類型。 例如,若要取消暫留追蹤,呼叫端必須傳遞 TME_CANCELTME_HOVER 旗標。
TME_HOVER
0x00000001
呼叫端想要暫留通知。 通知會以 WM_MOUSEHOVER 訊息的形式傳遞。

如果呼叫端要求暫留追蹤在暫留追蹤已在作用中時,暫留定時器將會重設。

如果滑鼠指標不在指定的視窗或區域上方,則會忽略此旗標。

TME_LEAVE
0x00000002
呼叫端想要離開通知。 通知會以 WM_MOUSELEAVE 訊息的形式傳遞。 如果滑鼠不在指定的視窗或區域上方,則會立即產生保留通知,而且不會執行進一步的追蹤。
TME_NONCLIENT
0x00000010
呼叫端想要暫留,並保留非客戶端區域的通知。 通知會以 WM_NCMOUSEHOVERWM_NCMOUSELEAVE 訊息的形式傳遞。
TME_QUERY
0x40000000
函式會填入 結構,而不是將它視為追蹤要求。 結構已填滿,因此結構已傳遞至 TrackMouseEvent,因此會產生目前的追蹤。 唯一的異常是傳回的暫留逾時一律是實際逾時,而不是HOVER_DEFAULT,如果在原始 TrackMouseEvent 要求期間指定了HOVER_DEFAULT

hwndTrack

類型: HWND

要追蹤之視窗的句柄。

dwHoverTime

類型: DWORD

如果在 dwFlags) 中指定了TME_HOVER,則暫留逾時 (以毫秒為單位。 可以是 HOVER_DEFAULT,這表示使用系統默認暫留逾時。

備註

系統預設暫留逾時最初是功能表下拉式時間,也就是 400 毫秒。 您可以呼叫 SystemParametersInfo ,並使用 SPI_GETMOUSEHOVERTIME 來擷取預設暫留逾時。

系統預設暫留矩形與按兩下矩形相同。 您可以呼叫 SystemParametersInfo 並使用 SPI_GETMOUSEHOVERWIDTHSPI_GETMOUSEHOVERHEIGHT 來擷取滑鼠指標必須保留的矩形大小, 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 winuser.h (包括 Windows.h)

另請參閱

滑鼠輸入