TrackMouseEvent

TrackMouseEvent
2011年12月22日
　　TrackMouseEvent
　　TrackMouseEvent函数
　　TrackMouseEvent函数在鼠标离开某一窗口或在某一窗口上停留超过某一特定时间长度时发送消息 。其函数原型：
　　BOOL TrackMouseEvent(LPTRACKMOUSEEVENT lpEventTrack);
　　参数lpEventTrack是一个指向TRACKMOUSEEVENT结构体的指针。
　　函数执行成功的话返回非零值(true)，否则返回零(false)。
　　该函数可以发送的消息包括：
　　WM_MOUSEHOVER
　　鼠标在窗口的某一客户区上停留上一次调用TrackMouseEvent函数时所设定的时间长度时发送。 在该消息产生之后将停止跟踪，如果需要进一步跟踪鼠标的停留事件，必须再次调用 TrackMouseEvent函数。
　　WM_MOUSELEAVE
　　当鼠标离开前一次调用TrackMouseEvent函数所设定的窗口的客户区时发送该消息。在产生该消息 时，所有由TrackMouseEvent请求的跟踪都将被取消。如果需要对鼠标的hover事件进行进一步的跟踪 ，必须在鼠标重新进入窗口里再次调用TrackMouseEvent函数
　　TRACKMOUSEEVENT结构体
　　TRACKMOUSEEVENT结构体在TrackMouseEvent函数中用到。
　　其定义如下：
　　typedef struct tagTRACKMOUSEEVENT {
　　DWORDcbSize;
　　DWORDdwFlags;
　　HWND  hwndTrack;
　　DWORDdwHoverTime;
　　} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;
　　几个成员的含义：
　　cbSize 定义TRACKMOUSEEVENT结构体的大小；
　　dwFlags 定义服务请求，可以是下列值的组合：
　　TME_CANCEL取消前一次的跟踪请求；使用该项时必须指定要取消跟踪的类型，例如要取消hover跟踪，就必须同时传送TME_CANCEL和TME_HOVER(TME_CANCEL|TME_HOVER)。
　　TME_HOVERhover通知。可以发送WM_MOUSEHOVER消息。如果在hover跟踪处于激活状态时再次请求hover跟踪的话，hover的定时器将被重置。
　　TME_LEAVE鼠标离开。发送TME_MOUSELEAVE消息。当鼠标不在指定的窗口或区域上时，将立即产生一个leave通知，不再做任何跟踪。
　　TME_QUERY这一项不是作为跟踪请求的。选中这一项时，当结构体被传送给TrackMouseEvent函数时，即产生当前跟踪。唯一不同的是返回的消耗时间，是真实的消耗时间而不是HOVER_DEFAULT，即使之前TrackMouseEvent函数所请求的是HOVER_DEFAULT。
　　hwndTrack 待跟踪窗口的句柄
　　dwHoverTime定义hover事件的耗尽时间(如果在dwFlags中有定义TME_HOVER的话），单位毫秒。
　　可以使用HOVER_DEFAULT来使用系统默认的hover事件耗尽时间。
　　系统默认的hover事件耗尽时间为菜单下拉时间，即400毫秒。可以调用SystemParameterInfo函数并使用SPI_GETMOUSEHOVERTIME来获取默认的hover耗尽时间。
　　默认的hover矩形区与双击区一致。可以调用SystemParameterInfo并使用SPI_GETMOUSEHOVERWIDTH和SPI_GETMOUSEHOVERHEIGHT来获取鼠标在上面停留可以产生WM_MOUSEHOVER的区域。
　　另外还有一个小问题。前面一直都说的是TrackMouseEvent函数，但实在上，在程序中，如果直接使用TrackMouseEvent(&tme);时，会出现诸如“'TrackMouseEvent': undeclared identifier”
　　的错误。但如果你使用_TrackMouseEvent(&tme);就不会有错误了。为什么呢？
　　这两个函数的区别，TrackMouseEvent函数的头文件是winuser.h，对应的库文件为user32.lib，而_TrackMouseEvent函数则在commctrl.h里定义，而由COMCTRL32.DLL导出。
　　使用TrackMouseEvent函数必须用extern "C"导入此函数。如下：
　　extern  "C"  WINUSERAPI  BOOL  WINAPI  TrackMouseEvent  (LPTRACKMOUSEEVENT 
　　lpEventTrack);
　　NOTE：由上面说到的TrackMouseEvent函数的特点，通常都在OnMouseMove函数里添加该函数。另外，可以与SetCapture函数联合使用，即使在鼠标移出窗口区时也能够响应。
　　再注(2010-10-21)：
　　今天再次发现，我在一个无标题栏的窗体上影响这面的东西，但是我在无标题栏的窗体里为拖动窗体做了 对系统的欺骗，欺骗系统窗体为标题栏来达到拖动的效果，结果导致这面的东西无法正常使用， 然后我换了另一种拖动无标题栏的方法，就可以正常使用了。
　　看来标题栏是不支持TrackMouseEvent这个方法的哈^_^
　　WM_MOUSELEAVE和WM_MOUSEHOVER不是标准的Windows消息函数，它们不能通过类向导来添加，所有的添加工作都需要通过手工输入代码来完成。
　　你可以先添加一个WM_MOUSEMOVE消息，看它生成了哪些代码，然后模仿。
　　其实手动添加WM_MOUSELEAVE和WM_MOUSEHOVER也不难。
　　1,在要相应这两个消息的类的头文件中加入
　　afx_msg LRESULT OnMouseLeave(WPARAM wParam, LPARAM lParam);
　　afx_msg LRESULT OnMouseHover(WPARAM wParam, LPARAM lParam);
　　（其实就是函数原型声明）
　　2,在该类的源文件的消息映射（BEGIN_MESSAGE_MAP和END_MESSAGE_MAP()之间）加入
　　ON_MESSAGE(WM_MOUSELEAVE, OnMouseLeave)
　　ON_MESSAGE(WM_MOUSEHOVER, OnMouseHover)
　　3,源文件中实现OnMouseLeave和OnMouseHover两个函数的功能。