CMyButton 中用到的几个Windows API 

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函数联合使用，即使在鼠标移出窗口区时也能够响应。

LoadImage

　　函数原型：HANDLE LoadImage（

　　HINSTANCE hinst，

　　LPCTSTR lpszName，

　　UINT uType，

　　int cxDesired，

　　int cyDesired，

　　UINT fuLoad

　　）；

　hinst：处理包含被装载图像模块的特例。若要装载OEM图像，则设此参数值为0。

　　lpszName：处理图像装载。如果参数hinst为non-NULL ，而且参数fuLoad省略LR_LOADFROMFILE的值时，那么参数lpszName是一个指向保留在hinst模块中装载的图像资源名称，并以NULL为结束符的字符串。

　　如果参数hinst为空，并且LR_LOADFROMFILE被指定，那么这个参数低位字一定是被装载的OEM图像标识的。OEM图像标识符是在WINUSER.H头文件中定义的，下面列举出前缀的含义：

　　OBM_ OEM：位图；OIC_OEM图标；OCR_OEM：光标。

　　如果参数fuLoad包含LR_LOADFROMFILE值，那么参数lpszName是包含有图像的文件名。

　　uType：指定被装载图像类型。此参数可以为下列值，其含义如下：

　　IMAGE_BITMAP：装载位图；IMAGE_CURSOR：装载光标；IMAGE_ICON：装载图标。

　　cxDesired：指定图标或光标的宽度，以像素为单位。如果此参数为零并且参数fuLoad值为LR_DEFAULTSIZE，那么函数使用SM_CXICON或SM_CXCURSOR系统公制值设定宽度；如果此参数为零并且值LR_DEFAULTSIZE没有被使用，那么函数使用目前的资源宽度。

　　cyDesired：指定图标或光标的高度，以像素为单位。如果此参数为零并且参数fuLoad值为LR_DEFAULTSIZE，那么函数使用SM_CXICON或SM_CXCURSOR系统公制值设定高度；如果此参数为零并且值LR_DEFAULTSIZE没有被使用，那么函数使用目前的资源高度。

　　fuLoad：根据下面复合值列表指定函数值，值含义如下：

　　LR_DEFAULTCOLOR：缺省标志；它不作任何事情。它的含义是“无LR_MONOCHROME”。

　　LR_CREATEDIBSECTION：当参数uType指定为IMAGE_BITMAP时，使得函数返回一个DIB部分位图，而不是一个兼容的位图。这个标志在装载一个位图，而不是映射它的颜色到显示设备时非常有用。

　　LR_DEFAULTSIZE：若 cxDesired或cyDesired未被设为零，使用系统指定的公制值标识光标或图标的宽和高。如果这个参数不被设置且cxDesired或cyDesired被设为零，函数使用实际资源尺寸。如果资源包含多个图像，则使用第一个图像的大小。

　　LR_LOADFROMFILE：根据参数lpszName的值装载图像。若标记未被给定，lpszName的值为资源名称。

　　LW_LOADMAP3DCOLORS：查找图像的颜色表并且按下面相应的3D颜色表的灰度进行替换。

　　颜色替代：Dk Gray RGB（128，128，128）COLOR_3DSHADOW；Gray RGB（192，192，192）COLOR_3DFACELt Gray RGB（223，223，223） COLOR_3DLIGHT LR_LOADTRANSPARENT；找到图像中的一个像素颜色值并且根据颜色表中系统的缺省颜色值替代其相应接口的值。图像中所有使用这种接口的像素的颜色都变为系统的缺省窗体颜色。此至仅用来申请相应的颜色表。

　　若fuLoad包括LR_LOADTRANSPARENT和LR_LOADMAP3DCOLORS两个值，则LRLOADTRANSPARENT优先。但是，颜色表接口由COLOR_3DFACE替代，而不是COLOR_WINDOW。

　　LR_MONOCHROME：装载黑白图。

　　LR_SHARED：若图像将被多次装载则共享。如果LR_SHARED未被设置，则再向同一个资源第二次调用这个图像时就会再装载一遍这个图像且返回不同的句柄。

　　不要对不同标准尺寸的图像使用LR_SHARED，装载后可能会有改变，或是从文件中被装载。

　　Windows 95和Windows 98：函数根据缓存中被请求的资源名发现的第一个图像，不管被请求的大小。LR_VGACOLOR：使用VGA真彩色。

　　返回值：如果函数运行成功，返回值是相关资源的数据的句柄。如果函数运行失败，返回值为NULL。若想获得更多的错误信息，请调用GetLastError函数。

　　注意：当使用完资源后，必须通过调用函数以释放加速器表、位图、光标、图标以及菜单所占的内存资源；加速器表：DesteoyAcceleratorTable；位图：DeleteObject；光标：DestroyCursor；图标：Destroylcon；菜单：DestroyMenu