MFC--关于NOTIFYICONDATA的一些新特性

注：本文转自 https://my.oschina.net/ypimgt/blog/92195

最近初接触MFC，是为了实现一个传感网络的上位机。
在实现托盘提示时，在网上搜索了不少资料，但已经翻译的资料都比较老。
在查看原版的MSDN后，发现NOTIFYICONDATA这个结构中有几项新特性，可以实现比较新的托盘/气泡特性。

例如：气泡操作响应(想想MSN的单击气泡关闭提示？)、隐藏图标|显示图标(不通过删除)、自定义大Balloon Tip图标等，还是比较吸引人的。

但是，实现这些功能的同时，需要一些额外的代码来提高程序的兼容性。

大Balloon Tip图标

我把自己摸索的一些结果总结出来吧：
在VS2008+MFC+XP和WIN7 64bit下进行测试通过。
先贴下NOTIFYICONDATA结构。

扫描二维码关注公众号，回复： 12214031 查看本文章

typedef   struct  _NOTIFYICONDATA {
   DWORD  cbSize; //
   HWND  hWnd;
   UINT  uID;
   UINT  uFlags; //
   UINT  uCallbackMessage; //
   HICON  hIcon; //
   TCHAR  szTip[64]; //
   DWORD  dwState;
   DWORD  dwStateMask;
   TCHAR  szInfo[256];
   union  {
   UINT  uTimeout;
   UINT  uVersion; //
};
   TCHAR  szInfoTitle[64];
   DWORD  dwInfoFlags; //
GUID guidItem; //
   HICON  hBalloonIcon; //
} NOTIFYICONDATA, *PNOTIFYICONDATA;

以下挑出几个不同的地方，一一做说明。

cbSize

网上通常的做法是

nid.cbSize=(DWORD)sizeof(NOTIFYICONDATA);

在最新的MSDN中指出：由于NOTIFYICONDATA结构体的大小在不同的Shell32.dll下，是不一样的，若是笼统的使用sizeof(NOTIFYICONDATA)来获取长度，使用的是当前定义的NOTIFYICONDATA结构长度，程序很可能在早期版本的Shell32.dll中无法运行。

在初始化NOTIFYICONDATA结构之前，我们可以使用函数

HRESULT CALLBACK DllGetVersion(DLLVERSIONINFO *pdvi);

来获取Shell32.dll的版本，并根据不同版本的Shell32.dll指定cbSize的大小。

DllGetVersion并不是一个API，具体的使用方法，请参看我另一篇博文《正确使用DllGetVersion》。

Shell32.dll Version	cbSize
6.0.6 or higher (Windows Vista and later)	sizeof(NOTIFYICONDATA)
6.0 (Windows XP)	NOTIFYICONDATA_V3_SIZE
5.0 (Windows 2000)	NOTIFYICONDATA_V2_SIZE
Versions lower than 5.0	NOTIFYICONDATA_V1_SIZE

请注意，cbSize中的长度不对时，会直接影响托盘图标能否显示，以及特性是否正常。

uFlags

新特性：

NIF_GUID

Windows 7 and later: 表示 guidItem 有效.
Windows Vista and earlier: 保留.

NIF_REALTIME

Windows Vista and later. 新增的特性，Balloon Tip若不能立即显示，则直接忽略掉。用于即时性要求较高的Balloon Tip。例如“你电话响了”（MSDN的例子），要联合NIF_INFO这个特性使用才有效。

NIF_SHOWTIP

Windows Vista and later. 在uVersion 被设置为 NOTIFYICON_VERSION_4时，标准的ToolTip(鼠标指向托盘图标时的那个提示)会被取消，也会被 application-drawn、弹出式UI等替代。在这个情况下，我们可以设置NIF_SHOWTIP打开ToolTip。

uCallbackMessage

这个消息传递的参数在uVersion 设置为 NOTIFYICON_VERSION_4后，变为如下的意义。

LOWORD(lParam) 包含了消息类型，例如：NIN_BALLOONSHOW,NIN_POPUPOPEN,WM_CONTEXTMENU。有许多人想实现对用户单击气泡的消息响应，就是在这里做消息的响应。
HIWORD(lParam) 为uID，缩短为16位，我们用这个确定是哪一个托盘图标的消息。
GET_X_LPARAM(wParam) 返回鼠标消息时，为鼠标的X坐标。如果消息从键盘产生，wParam 包含的坐标为目标ICON的左上角坐标，其他消息时wParam 未定义。
GET_Y_LPARAM(wParam) 返回鼠标消息时，为鼠标的Y坐标。其他意义与GET_X_LPARAM(wParam)相同。

hIcon

XP和之后的版本支持32BPP的ICON。最好同时提供16x16、32x32的图标。在追求高DPI图标的情况下，可以使用如下函数加载图标，但此函数仅可在Vista及以上版本的系统中使用，若在代码中包含此语句，即便该函数运行时不被调用，程序也不可以在XP下执行(双击后直接报错)。

LoadIconMetric(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDR_MAINFRAME), LIM_LARGE, &(nid.hBalloonIcon));

szTip

Windows2000之后支持128字节，包括NULL。

uTimeout

该值在Vista及之后系统下无效，此时间由系统决定。在其他情况下：最大值30秒，最小值10秒。单位为毫秒。另外有一点，就是关于XP下气泡提示不会自动消失的情况。MSDN中也指出这是一个存在的现象，当用户没有操作时(任何操作，例如单击开始菜单之类)，气泡是不会消失的(XP)。个人觉得，为了保险，还是自己使用定时关闭Balloon Tips的好…

uVersion

这是一个比较关键的值

Windows 2000之前的操作系统使用，也是默认值.

NOTIFYICON_VERSION

使用Windows 2000特性，用于Windows 2000以及之后版本.

NOTIFYICON_VERSION_4

使用当前系统风格，用于Vista与之后的版本.

若我们要实现气泡上的操作的响应，我们必须设定为NOTIFYICON_VERSION_4，才能在CallbackMessage中响应到关于气泡的消息。当然其他消息也要按照上文中说明的来提取消息类型。

还有一点关键就是，要实现uVersion的设置，必须调用

Shell_NotifyIcon(NIM_SETVERSION,&nid);

才能实现版本的更改。

dwInfoFlags

新特性：

NIIF_USER

Windows XP: 使用hIcon做Balloon Tip的标题图标。
Windows Vista and later:使用 hBalloonIcon 做Balloon Tip的标题图标。

NIIF_LARGE_ICON

Windows Vista and later. 使用大图标做Balloon Tip的标题图标，对应的图标大小为SM_CXICON x SM_CYICON，如果不设置这个标记，那么使用的是XM_CXSMICON x SM_CYSMICON 大小的图标。
使用旧版本定制图标的程序(NIIF_USER 标记，使用 hIcon) ，也就是XP下，必须提供 SM_CXICON x SM_CYICON 版本的 hIcon。托盘区的hIcon会自动缩小至XM_CXSMICON x SM_CYSMICON 大小。
使用新版本定制图标的程序(NIIF_USER 标记，使用 hBalloonIcon) ，也就是Vista之后的版本，hBalloonIcon必须有 SM_CXICON x SM_CYICON 大小。

NIIF_RESPECT_QUIET_TIME

MSDN中指出，在当前用户处于"quiet time"时，不显示，直接忽略该Balloon Tip，亦不进入Balloon Tip的等待队列。
至于这个"quiet time"是指：用户第一次登陆他的账户后的几个小时之内(which is the first hour after a new user logs into his or her account for the first time)，并且系统更新与清理之后也会进入"quiet time"。MSDN说，是为了在用户适应新的电脑与环境之时，不被打扰而提供的功能。当然，程序需要用户立即做出回应，可以不用此标记，例如插入一个USB设备，或者正在打印一个文档之类的信息。

guidItem

XP和之后系统的特性

Windows 7 and later: 需要一个已注册的GUID代替uID来指示托盘图标(MSDN推荐的做法)，需要在uFlags中置位NIF_GUID。
Windows XP and Windows Vista:保留，必须为0。

若程序要同时运行在Vista 与 WIN7，必须在程序中判断系统版本，再指定该值。

若设置了GUID，GUID则代替uID来操作托盘图标，切记。

可以使用GUID生成工具例如Guidgen.exe来生成一个有效的GUID。

hBalloonIcon

Windows Vista and later. Balloon Tip标题图标句柄，dwInfoFlags 中NIIF_USER中置位后，若改为为0，则用传统的Balloon Tip标题图标

以上就是NOTIFYICONDATA的一些新特性，以2010年12月11日官方英文MSDN为原版的翻译与一些自己的提示。

需注意的是，在网上许多资料对气泡不弹出的解决办法，都是对以下的宏定义进行修改：

#ifndef WINVER                          // 指定要求的最低平台是 Windows Vista。
#define WINVER 0x0600           // 将此值更改为相应的值，以适用于 Windows 的其他版本。
#endif
#ifndef _WIN32_WINNT            // 指定要求的最低平台是 Windows Vista。

#define _WIN32_WINNT 0x0600 // 将此值更改为相应的值，以适用于 Windows 的其他版本。

若是按其更改为0x0501之后，类似 NOTIFYICON_VERSION_4,hBalloonIcon等这些6.0版本的宏定义与成员是不可直接使用的。

其实，这种解决办法是错误的，请设置该值为默认值。

气泡不能正常显示，正是上文提及的cbSize的值设置不正确所导致的。

因为在该宏定义为0x0600时，NOTIFYICONDATA结构声明为上文中贴出的结构，而笼统使用sizeof获取的大小，亦为这个大小。但在XP中运行时，Shell32.dll版本较低，NOTIFYICONDATA中类似hBalloonicon等成员不存在，长度不一致，从而导致托盘异常，气泡无法正常显示。为了正常显示托盘气泡，一定要设置正确的cbSize值。

下面给出一个CallbackMessage的函数例子，用于NOTIFYICON_VERSION_4时的消息处理，可以实现气泡单击，关闭之类的消息处理。

LRESULT  CUSB_sensorDlg::OnICON( WPARAM  wParam, LPARAM  lParam)
{
   if (HIWORD(lParam) != uID) //uID为你指定的托盘图标uID，过滤其他托盘程序的消息
   return    0;
   switch (LOWORD(lParam))
{
   case    WM_RBUTTONUP: //右键弹起
   //添加代码
   break ;
   case    WM_LBUTTONDBLCLK: //双击左键的处理
   //添加代码
   break ;
   case  NIN_BALLOONUSERCLICK: //用户单击气泡处理
   //添加代码
   break ;
}
   return    0;
}

再给出一个简单的大图标Balloon Tip例子：

nid.cbSize=( DWORD ) sizeof (NOTIFYICONDATA);
nid.hWnd= this -> m_hWnd;
nid.uID=IDR_MAINFRAME;
nid.uFlags=NIF_ICON|NIF_MESSAGE|NIF_TIP|NIF_INFO | NIF_SHOWTIP;
nid.uCallbackMessage=WM_ICON; //自定义的消息名称
nid.hIcon=LoadIcon(AfxGetInstanceHandle(),MAKEINTRESOURCE(IDR_MAINFRAME));
wcscpy_s(nid.szTip, _T( "标准ToolTips" ));
wcscpy_s(nid.szInfo,_T( "气泡内容" ));
wcscpy_s(nid.szInfoTitle,_T( "气泡标题" ));
nid.uVersion=NOTIFYICON_VERSION_4; //打开高版本
nid.dwInfoFlags= NIIF_USER | NIIF_LARGE_ICON ;    //打开自定义及大图标提示
nid.hBalloonIcon=LoadIcon(AfxGetInstanceHandle(),MAKEINTRESOURCE(IDR_MAINFRAME));
Shell_NotifyIcon(NIM_ADD,&nid); //在托盘区添加图标
Shell_NotifyIcon(NIM_SETVERSION,&nid); //设置vista效果的balloon tips

另外，可能有人不知道如何立即关闭BalloonTip，只要令szInfo的内容为空，再修改图标，就可以立即关闭提示。

最后再提醒一点，使用了新特性的程序，很可能在XP下无法使用。所以，想让自己的程序拥有美丽的外观的同时，又能在XP下正常运行，一定要善用上文提及的函数判断shell32.dll版本之后，再配置NOTIFYICONDATA结构体。

虽然大图标提示很美观，但也不要滥用提示，除非是自用的，不然用户很可能彻底告别你的程序！

MFC--关于NOTIFYICONDATA的一些新特性

猜你喜欢