龙空技术网

Qt之自定义托盘(一)

QT教程 636

前言:

眼前朋友们对“windows 托盘”大体比较讲究,同学们都想要了解一些“windows 托盘”的相关知识。那么小编在网络上收集了一些对于“windows 托盘””的相关知识,希望兄弟们能喜欢,朋友们一起来了解一下吧!

说起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示例链接:

mfc示例链接:

标签: #windows 托盘