系统托盘编程完全指南(3)

核心提示：气球提示为托盘程序提供了一种非打扰式的方法通知用户发生了某件事情，但是如何让气球提示显示出来呢？所有的托盘图标行为都是通过一个单纯的API函数Shell_NotifyIcon来操作的，系统托盘编程完全指南(3)(2)，这个函数的一个参数是NOTIFYICONDATA结构，你可以利用这个结构来告诉Windows你想要做什

气球提示为托盘程序提供了一种非打扰式的方法通知用户发生了某件事情。但是如何让气球提示显示出来呢？所有的托盘图标行为都是通过一个单纯的API函数Shell_NotifyIcon来操作的。这个函数的一个参数是NOTIFYICONDATA结构，你可以利用这个结构来告诉Windows你想要做什么。下面是这个结构的定义的最新版本（For IE5.0+），其中已经加入了新的成员：

typedef struct _NOTIFYICONDATA {
　　DWORD cbSize;
　　HWND hWnd;
　　UINT uID;
　　UINT uFlags;
　　UINT uCallbackMessage;
　　HICON hIcon;
　　#if (_WIN32_IE < 0x0500)
　　　　WCHAR　szTip[64];
　　#else
　　　　WCHAR　szTip[128];
　　#endif
　　#if (_WIN32_IE >= 0x0500)
　　　　DWORD dwState;
　　　　DWORD dwStateMask;
　　　　WCHAR　szInfo[256];
　　　　union {
　　　　　　UINT　uTimeout;
　　　　　　UINT　uVersion;
　　　　} DUMMYUNIONNAME;
　　　　WCHAR　szInfoTitle[64];
　　　　DWORD dwInfoFlags;
　　#endif
} NOTIFYICONDATA, *PNOTIFYICONDATA;

有关这个结构的详细信息和用法请参考本文前面的两个部分：

系统托盘编程完全指南（一）

系统托盘编程完全指南（二）

在NOTIFYICONDATA.uFlags中的标志之一是NIF_TIP，用它来设置传统的信息提示，即鼠标要移动到图标上。新的标志NIF_INFO（由于_WIN32_IE >= 0x0500条件定义，因此在编译时，请注意包含最新版本的头文件shellapi.h，并保证链接最新版本的库文件shell32.lib，分发程序时用最新版本的运行时动态链接库shell32.dll）便是为显示气球提示所用的。也就是说，要显示气球提示，那么在调用Shell_NotifyIcon函数时必须用NIF_INFO标志。提示文本填入szInfo域，标题文本填入szInfoTitle。你甚至可以在NOTIFYICONDATA.uTimeout中设置一个超时时间，当经过指定的毫秒数之后，气球提示自动隐藏。

为了示范气球提示的实现原理，我对本文前面两个部分的例子以及CTrayIcon类进行了修改。CTrayIcon类中添加了一个新的方法ShowBalloonTip，这个方法有两个重载函数，既可以用文本串来调用，也可以用资源ID来调用。用资源ID时，可以有选择地加载文本串，并调用ShowBalloonTip的文本串版本，原型如下：

BOOL CTrayIcon::ShowBalloonTip(LPCTSTR szMsg,
　LPCTSTR szTitle, UINT uTimeout, DWORD dwInfoFlags)
{
　m_nid.cbSize=sizeof(NOTIFYICONDATA);
　m_nid.uFlags = NIF_INFO;
　m_nid.uTimeout = uTimeout;
　m_nid.dwInfoFlags = dwInfoFlags;
　strcpy(m_nid.szInfo,szMsg ? szMsg : _T(""));
　strcpy(m_nid.szInfoTitle,szTitle ? szTitle : _T(""));
　return Shell_NotifyIcon(NIM_MODIFY, &m_nid);
}