您的位置:首页 > 其它

TrackMouseEvent与_TrackMouseEvent

2012-10-16 14:11 274 查看
函数功能:当在指定时间内鼠标指针离开或盘旋在一个窗口上时,此函数寄送消息。

函数原型:BOOL TrackMouseEvent(LPTRACKMOUSEEVENT lpEventTrack);

参数:lpEventTrack;指向结构TRACKMOUSEEVENT的指针。  

返回值:如果函数调用成功,返回非零值;如果函数调用失败,返回值是零。若想获得更多的错误信息,请调用GetLastError函数。

此函数能寄送如下消息:

WM_MOUSEHOVER:在调用TrackMouseEvent后指定的时间里,鼠标仍盘旋在窗口的客户区,此消息产生,盘旋跟踪停止。如果需要进一步的鼠标盘旋跟踪,应用程序应当再次调用TrackMouseEvent。

WM_MOUSELEAVE:在调用TrackMouseEvent后,鼠标离开参数TRACKMOUSEEVENT结构指定的窗口客户区时,此消息产生,所有由TrackMouseEvent要求的跟踪都被取消。当鼠标再次进入窗口,并且要求进一步的鼠标盘旋跟踪时,应用程序必须调用TrackMouseEvent。

 该处使用自定义消息发送形式:  

ON_MESSAGE(WM_MOUSELEAVE,OnMouseLeave)

ON_MESSAGE(WM_MOUSEHOVER,OnMouseHover)

注意:WM_MOUSELEAVE响应函数为 void OnMouseLeave(WPARAM wp,LPARAM lp),若写成 void OnMouseLeave(),Release下运行会出现错误。

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_HOVER:定义后鼠标在指定窗口停留一定时间后会发送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函数联合使用,即使在鼠标移出窗口区时也能够响应。

CSDN原文连接http://topic.csdn.net/t/20020423/17/670254.html

详细说明见下面的原文,这里做一点补充:

按原文的做法会遇到在上一篇文章中http://hi.baidu.com/liuqizealot/blog/item/60bfabd3d14c8934970a1691.html提到的错误,那就是Debug模式下正常运行而在Release模式下却非法操作。原因仍然是消息处理函数中没有加上形参;

解决方法自然是在申明和实现消息处理函数的时候加上形参,不过要注意的是OnMouseLeave的形参是WPARAM wp和LPARAM lp而不是和OnMouseMove一样的UINT nFlags与 CPoint point,也就是说OnMouseLeave申明的时候应该是afx_msg void OnMouseLeave(WPARAM wp,LPARAM lp);

实现的时候应该是void CMyWin::OnMouseLeave(WPARAM wp,LPARAM lp) ,CMyWin是所在的类名。

原文如下

文章引自 http://vcworm.51.net
=============================================

用mousemove判断鼠标离开窗口会捕捉不完全,加SetCapture会产生很多副作用。那么究竟该怎样判断呢?这篇文章给出了一个办法。

如何判断鼠标已经离开窗口(http://vcworm.51.net)

使用_TrackMouseEvent函数可以使系统在鼠标离开窗口的时候发送一个WM_MOUSELEAVE的消息。

使用方法:

1、在头文件声明消息响应函数

afx_msg void OnMouseLeave();

2、在cpp文件定义消息响应函数

void CMyWin::OnMouseLeave()
{
MessageBox("鼠标已离开");
}

3、添加消息映射

ON_MESSAGE(WM_MOUSELEAVE,OnMouseLeave)

4、调用_TrackMouseEvent();捕获鼠标离开的事件
void CMyWin::OnMouseMove(UINT nFlags, CPoint point)
{
if (!m_bTrackLeave)
{// 鼠标第一次移入窗口时, 请求一个WM_MOUSELEAVE 消息
TRACKMOUSEEVENT tme;
tme.cbSize = sizeof(tme);
tme.hwndTrack = m_hWnd;
tme.dwFlags = TME_LEAVE;
_TrackMouseEvent(&tme);
m_bTrackLeave = TRUE;
}
CWnd::OnMouseMove(nFlags, point);
}

http://blog.sina.com.cn/s/blog_5d97bfa40100xb4h.html
http://topic.csdn.net/t/20040208/19/2713433.html
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: