请输入您要查询的百科知识:

 

词条 TrackMouseEvent
释义

函数功能:当在指定时间内鼠标指针离开或盘旋在一个窗口上时,此函数寄送消息。

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

参数:

lpEventTrack;指向结构TRACKMOUSEEVENT的指针。

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

此函数能寄送如下消息:

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

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

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

ON_MESSAGE(WM_MOUSELEAVE,OnMouseLeave)

ON_MESSAGE(WM_MOUSEHOVER,OnMouseHover)

才能使用

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

备注:当鼠标指针在指定时间内停留在指定矩形内,就被认为是处于盘旋状态。调用函数

SystemParameterslnfo并使用SPI_GETMOUSEAOVERWIDTH,SPI_GETMOUSEHOVERAEIGHT和

SFI_GETMOOSEAOVERTIME值来取得矩形的大小和时间。

速查:Windows NT 4.0及以上版本;Windows 98及以上版本;Windows CE:1.0及以上版本;头文件:winuser.h;输入库:user32.lib。

::TrackMouseEvent 要使用它,请在源码中包含#define _WIN32_WINNT 0x0400

TRACKMOUSEEVENT 结构体

TRACKMOUSEEVENT结构体在TrackMouseEvent函数中用到。

其定义如下:

typedef struct tagTRACKMOUSEEVENT {

DWORD cbSize;

DWORD dwFlags;

HWND hwndTrack;

DWORD dwHoverTime;

} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;

几个成员的含义:

cbSize 定义TRACKMOUSEEVENT结构体的大小;

dwFlags 定义服务请求,可以是下列值的组合:TME_CANCEL 取消前一次的跟踪请求;使用该项时必须指定要取消跟踪的类型,例如要取消hover跟踪,就必须同时传送TME_CANCEL和 TME_HOVER(TME_CANCEL|TME_HOVER)。TME_HOVER 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函数联合使用,即使在鼠标移出窗口区时也能够响应。

随便看

 

百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2025/3/22 13:11:36