TRACKMOUSEEVENT 結構 (winuser.h)
TrackMouseEvent 函式用來追蹤滑鼠指標離開視窗的時間,或將滑鼠停留在視窗上的指定時間量。
語法
typedef struct tagTRACKMOUSEEVENT {
DWORD cbSize;
DWORD dwFlags;
HWND hwndTrack;
DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;
成員
cbSize
類型: DWORD
TRACKMOUSEEVENT 結構的大小,以位元組為單位。
dwFlags
類型: DWORD
所要求的服務。 這個成員可以是下列值的組合。
值 | 意義 |
---|---|
|
呼叫端想要取消先前的追蹤要求。 呼叫端也應該指定想要取消的追蹤類型。 例如,若要取消暫留追蹤,呼叫端必須傳遞 TME_CANCEL 和 TME_HOVER 旗標。 |
|
呼叫端想要暫留通知。 通知會以 WM_MOUSEHOVER 訊息的形式傳遞。
如果呼叫端要求暫留追蹤在暫留追蹤已在作用中時,暫留定時器將會重設。 如果滑鼠指標不在指定的視窗或區域上方,則會忽略此旗標。 |
|
呼叫端想要離開通知。 通知會以 WM_MOUSELEAVE 訊息的形式傳遞。 如果滑鼠不在指定的視窗或區域上方,則會立即產生保留通知,而且不會執行進一步的追蹤。 |
|
呼叫端想要暫留,並保留非客戶端區域的通知。 通知會以 WM_NCMOUSEHOVER 和 WM_NCMOUSELEAVE 訊息的形式傳遞。 |
|
函式會填入 結構,而不是將它視為追蹤要求。 結構已填滿,因此結構已傳遞至 TrackMouseEvent,因此會產生目前的追蹤。 唯一的異常是傳回的暫留逾時一律是實際逾時,而不是HOVER_DEFAULT,如果在原始 TrackMouseEvent 要求期間指定了HOVER_DEFAULT。 |
hwndTrack
類型: HWND
要追蹤之視窗的句柄。
dwHoverTime
類型: DWORD
如果在 dwFlags) 中指定了TME_HOVER,則暫留逾時 (以毫秒為單位。 可以是 HOVER_DEFAULT,這表示使用系統默認暫留逾時。
備註
系統預設暫留逾時最初是功能表下拉式時間,也就是 400 毫秒。 您可以呼叫 SystemParametersInfo ,並使用 SPI_GETMOUSEHOVERTIME 來擷取預設暫留逾時。
系統預設暫留矩形與按兩下矩形相同。 您可以呼叫 SystemParametersInfo 並使用 SPI_GETMOUSEHOVERWIDTH 和 SPI_GETMOUSEHOVERHEIGHT 來擷取滑鼠指標必須保留的矩形大小, 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
標頭 | winuser.h (包括 Windows.h) |