关于NOTIFYICONDATA的一些新特性
关于NOTIFYICONDATA的一些新特性
最近初接触MFC，是为了实现一个传感网络的上位机。
在实现托盘提示时，在网上搜索了不少资料，但已经翻译的资料都比较老。
在查看原版的MSDN后，发现NOTIFYICONDATA这个结构中有几项新特性，可以实现比较新的托盘/气泡特性。
例如：气泡操作响应(想想MSN的单击气泡关闭提示？)、隐藏图标|显示图标(不通过删除)、自定义大Balloon Tip图标等，还是比较吸引人的。
但是，实现这些功能的同时，需要一些额外的代码来提高程序的兼容性。
我把自己摸索的一些结果总结出来吧：
在VS2008+MFC+XP和WIN7 64bit下进行测试通过。
先贴下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结构之前，我们可以使用函数
来获取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下执行(双击后直接报错)。
szTip
Windows2000之后支持128字节，包括NULL。
uTimeout
该值在Vista及之后系统下无效，此时间由系统决定。在其他情况下：最大值30秒，最小值10秒。单位为毫秒。另外有一点，就是关于XP下气泡提示不会自动消失的情况。MSDN中也指出这是一个存在的现象，当用户没有操作时(任何操作，例如单击开始菜单之类)，气泡是不会消失的(XP)。个人觉得，为了保险，还是自己使用定时关闭Balloon Tips的好…
uVersion
这是一个比较关键的值
- 0
Windows 2000之前的操作系统使用，也是默认值.
- NOTIFYICON_VERSION
使用Windows 2000特性，用于Windows 2000以及之后版本.
- NOTIFYICON_VERSION_4
使用当前系统风格，用于Vista与之后的版本.
若我们要实现气泡上的操作的响应，我们必须设定为NOTIFYICON_VERSION_4，才能在CallbackMessage中响应到关于气泡的消息。当然其他消息也要按照上文中说明的来提取消息类型。
还有一点关键就是，要实现uVersion的设置，必须调用
才能实现版本的更改。
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时的消息处理，可以实现气泡单击，关闭之类的消息处理。
{
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.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结构体。
虽然大图标提示很美观，但也不要滥用提示，除非是自用的，不然用户很可能彻底告别你的程序！
若是有帮助，留个言支持下，我会继续写一些个人的经验与大家分享~
欢迎留言交流问题与经验~若是有错误，还请指正！