Qt之自定义托盘(一)

说起Qt，真是个不错的ui库，不仅仅ui做的好，其他方面也不差，在平台扩展方面也是非常的强大。这篇文章我将会分析下qt的托盘，QSystemTrayIcon是qt的托盘类，托盘类的用途是什么我就不说了，自行百科就好，关键问题是我们要实现自定义的托盘。

说起常用的客户端软件，qq，微信等聊天工具，有这么几个托盘事件：

1、来消息图标闪烁

2、气泡消息提示

3、鼠标左键单击、左键双击、右键单击、滚动单击

上述这三种事件QSystemTrayIcon类都完全能够解决，但是托盘的hover事件却无能为力，如图1所示，途图中是帮助文档中的一段描述，指明了只有在x11系统中，可以捕获到系统的tooltip事件，其他系统都无能为力，我自己也看了下qt的源码，果真是这样的，有兴趣的同学可以自行在研究下。

图1 帮助文档

如图2所示，qq有消息时，鼠标hover在图盘弹出菜单，那么qq是怎么做的呢，既然qq都到做到了，这个功能我们自己想必肯定也能实现。

图2 托盘hover弹框

好了，上边说了这么多，仅仅是为了铺垫我自己实现的托盘，完全脱离了qt中的托盘类QSystemTrayIcon，不过也不能说完全脱离，部分代码还是从qt源码中摘出来的。文章的最后我附上我自己用qt实现的自定义托盘和下载别人用mfc自定义实现的自定义托盘。

因为win32我自己也不是特别了解，因此我也是大概说下自定义托盘需要了解的东西，首先是NOTIFYICONDATA结构，这个结构百科讲的特别详细，看一下就知道怎么用，然后是Shell_NotifyIcon这个api，这个方法就是对托盘操作的接口。具体参数百科中说的很详细，不过如果你不想看也无所谓，直接往下看也可以。对盘托的操作在windows平台下都是一样的，关键问题是用qt怎么接受这个图盘的hover和leave消息。

关于这个托盘的实现我也是从mfc的示例代码中获取的启发，然后用qt方法实现，接下来我就直接说下用qt实现的步骤：

1、首先我们需要了解下QAbstractNativeEventFilter这个接口类，继承这个接口类的类可以把自己注册到app中，然后就能获取到整个app

的事件，事件的处理函数为nativeEventFilter，该类有3个参数，具体可以参见这篇文字qt捕获全局windows消息 这个文章中说的不全是对的，不过能抓取到app消息应该是没问你的，本篇博客的demo也是印证了这个问题。注册代码如下：

1 qApp->installNativeEventFilter(this);

2、第二步就是创建托盘图标，创建托盘图标的时候，windows提供了api，代码如下：

 1 NOTIFYICONDATA    nid;
 2     QLabel *l = new QLabel;
 3     nid.cbSize = sizeof nid;
 4     nid.hIcon = qt_pixmapToWinHICON(QIcon(":/trayIcon/Resources/childrenWidget.ico").pixmap(16, 16));
 5     nid.hWnd = HWND(l->winId());
 6     nid.uCallbackMessage = WM_TRAYNOTIFY;
 7     nid.uID = 1;
 8     nid.uFlags = NIF_ICON | NIF_MESSAGE;
 9 
10     Shell_NotifyIcon(NIM_ADD, &nid);

此处代码中有一个标签l，创建他是因为创建图标时需要一个接受鼠标事件的窗口句柄hWnd，如果没有句柄，那么托盘也不能创建成功；其他成员的含义从变量的命名上应该也能理解，我重点说下uFlags这个变量，他其实本身没有什么含义，主要是为了标示NOTIFYICONDATA结构中其他成员那个是有效的，这个也方便了我们后续对托盘图标的修改。比如说修改tooltip、修改图标等信息。uCallbackMessage是消息id，在我们后续处理的逻辑中会用到

3、鼠标事件处理

 1 bool trayIcon::nativeEventFilter(const QByteArray & eventType, void * message, long * result)
 2 {
 3     if (eventType == "windows_generic_MSG" || eventType == "windows_dispatcher_MSG")
 4     {
 5         MSG * pMsg = reinterpret_cast<MSG *>(message);
 6         if (pMsg->message == WM_TRAYNOTIFY)
 7         {
 8             switch (pMsg->lParam)
 9             {
10             case WM_MOUSEMOVE:
11                 m_traypos.OnMouseMove();
12                 break;
13             case WM_MOUSEHOVER:
14                 m_Menu->show();
15                 break;
16             case WM_MOUSELEAVE:
17                 m_Menu->hide();
18                 break;
19             case WM_LBUTTONDBLCLK:
20             //    m_Menu->show();
21                 break;
22             case WM_LBUTTONDOWN:
23             //    m_Menu->show();
24                 break;
25             case WM_RBUTTONDOWN:
26             //    m_Menu->show();
27                 break;
28             }
29         }
30     }
31 
32     return false;
33 }

上述代码主要是针对鼠标事件的一个处理。WM_TRAYNOTIFY消息是我们开始的时候注册到图盘中的消息，当托盘发生鼠标事件的时候我们只需要关注自己注册的消息，对于windows托盘稍微有了解的同学可能也知道，微软没有提供给我们托盘图标的进入和离开事件，而仅仅提供了鼠标move的事件，不过仅仅有这一个事件我们就可以模拟出其他的事件来。细心的同学将会注意到 m_traypos.OnMouseMove();这句代码，其实m_tryapos这个对象是一个move事件处理类，他可以模拟出鼠标hover和leave事件来。关于这个类的解释我就不说了，是一个国外的大牛写的，demo中有源文件。

点击领取Qt学习资料+视频教程~「链接」

4、程序退出时销毁托盘图标

Shell_NotifyIcon(NIM_DELETE, &m_NotifyIconData);

通过上述的代码整理，简单的托盘就可以实现了，因为我是自己做的demo，因此不是所有事件的处理了的，高级定制的功能如果有兴趣的同学可以给我留言，或者私信我可以，如果是我实现了的，我将愿意和大家一起分享。我下边链接中的这个demo其实比较粗糙，就仅仅的可以实现鼠标在托盘图标上的hover和leave请求。

最后我上两张效果图，图3是mfc示例的鼠标hover截图，图4是qt示例的鼠标hover截图

图3 mfc示例demo

图4 qt示例demo

注意：这个demo非常粗糙，不过我已经讲明了怎么实现一个自己的托盘，关于需要怎么实现一个完美的托盘，同学们可以参考qt的源码中qsystemtrayicon_win.cpp文件，该文件就是QSystemTrayIcon类的真正实现。

qt示例链接：http://download.csdn.net/detail/qq_30392343/9608076

mfc示例链接：http://download.csdn.net/detail/qq_30392343/9608078