共用方式為

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_CANCEL 和 TME_HOVER 旗標。
TME_HOVER
0x00000001
 呼叫端想要暫留通知。 通知會以 WM_MOUSEHOVER 訊息的形式傳遞。

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

如果滑鼠指標不在指定的視窗或區域上方，則會忽略此旗標。
TME_LEAVE
0x00000002
 呼叫端想要離開通知。 通知會以 WM_MOUSELEAVE 訊息的形式傳遞。 如果滑鼠不在指定的視窗或區域上方，則會立即產生保留通知，而且不會執行進一步的追蹤。
TME_NONCLIENT
0x00000010
 呼叫端想要暫留，並保留非客戶端區域的通知。 通知會以 WM_NCMOUSEHOVER 和 WM_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_GETMOUSEHOVERWIDTH 和 SPI_GETMOUSEHOVERHEIGHT 來擷取滑鼠指標必須保留的矩形大小， 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。

規格需求

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

另請參閱

滑鼠輸入