Qt之自定义托盘(二)

上一篇文章讲述了自定义Qt托盘，不过不是使用QSystemTrayIcon这个类，而是我们自己完全自定义的一个类，我们只需要处理这个类的鼠标hover、鼠标左键点击、鼠标右键点击和鼠标左键双击，就可以完全模拟出qq的托盘样式来。文章的最后我也是提供了一个demo的下载链接，那是一个可以完全运行的demo，处理了鼠标hover事件，并模拟出了鼠标离开和进入事件，这一节我将一步一步讲解怎么实现一个完美的托盘，包括托盘菜单的显示、托盘tooltip和托盘hover时的弹框显示。

看本片文章之前，同学们最好把Qt之自定义托盘文章读一读，这篇文章中有win32的几个api的讲解，虽然不细致，但是讲到了他们的作用，并说明了一些用法。

在本篇内容讲解之前，我先贴一段代码，也算是对上一届内容的回顾吧，这个接口是QAbstractNativeEventFilter类的，该接口如果要处理app的消息，需要使用qApp这个指针把CSystemTrayIcon对象注册下，具体代码上一节中有介绍，这里我就不多说啦。

 bool CSystemTrayIcon::nativeEventFilter(const QByteArray & eventType, void * message, long * result)
 {
     if (eventType == "windows_generic_MSG" || eventType == "windows_dispatcher_MSG")
     {
         MSG * pMsg = reinterpret_cast<MSG *>(message);

         if (pMsg->message == WM_TRAYNOTIFY)
         {
             switch (pMsg->lParam)
             {
             case WM_MOUSEMOVE:
                 m_PTrayPos.OnMouseMove();
                 break;
             case WM_MOUSEHOVER:
             {
                 HandleMouseHover();
             }
             break;
             case WM_MOUSELEAVE:
             {
                 HandleMouseLeave();
             }
             break;
             case WM_LBUTTONUP:
             {
                 TrayActivateSlot(QSystemTrayIcon::Trigger);
             }
             break;
             case NIN_BALLOONUSERCLICK: //用户单击气泡处理
             {

             }
             break;
             case WM_LBUTTONDBLCLK:
             {
                 emit DblClickTray();
             }
             break;
             case WM_RBUTTONUP:
             {
                 m_MenuPopPos = QCursor::pos();
                 emit ShowPopupWidget(m_MenuPopPos, false);
                 m_Menu->show();
                 *result = ;
             }
             break;
             }
         }
     }

     return false;
 }

这个本地事件过滤器，可以处理经过这个app的所有事件，因此他可以处理鼠标移动到托盘上的消息，有了hover这个消息，我们自己就可以模拟出enter和leave这两个消息了(enter和leave消息windows托盘区域没有提供)，其他鼠标事件都是可以直接拿到，后边只需要处理我们自己的具体业务。

一、菜单

一个完美的托盘，往往都有右键菜单，而右键菜单也是托盘的一项重要功能，如果想实现自定义的托盘菜单，请看文章qt之菜单项定制，这篇文章中讲述到了自定义菜单，应该可以满足大多数人的需求，起码实现360或者电脑管家那样的右键菜单是没有问题。

上边给出的链接就可以实现一个自定义并且美观的菜单项，接下来，我主要说下右键菜单显示的问题，首先我说明一个问题，右键菜单显示的位置应该是我们右键点击的位置，我强调这句话的原因是后边我们讲解鼠标hover弹框时，会和右键菜单有所区别。Qt的菜单也是一个窗口，他继承自QWidget，只不过菜单含有Qt：：Popup属性，当他失去焦点的时候，就会自动隐藏。

鼠标右键在托盘区域点击右键，我们响应WM_RBUTTONUP消息，然后show出右键菜单，这个时候我们就需要做一件事情，必须保证我们自己显示的右键菜单在屏幕内，关于这个我问题，我也不多说，一切看代码，代码逻辑也比较简单，首先把菜单移动到鼠标右键点击的位置，然后判断鼠标鼠标是否在界面内，如果需要移动的话，水平移动就移动菜单的宽度，垂直方向就移动菜单的高度，具体怎么移动需要判断窗口的那个边出屏幕。

说了这么多，其实修正代码也比较简单，如下：

 QPoint MenuWholePos(const QWidget * widget, const QPoint & proposal)//获取能完全显示菜单的位置
     {
         QRect wRect = widget->rect();
         if (QDesktopWidget * desktop = qApp->desktop())
         {
             QRect rect = desktop->screenGeometry(desktop->primaryScreen());
             wRect.moveTo(proposal);

             if (rect.contains(QPoint(wRect.left(), )) == false)
             {
                 wRect.translate(widget->width(), );
             }

             if (rect.contains(QPoint(wRect.right(), )) == false)
             {
                 wRect.translate(-widget->width(), );
             }

             if (rect.contains(QPoint(, wRect.bottom())) == false)
             {
                 wRect.translate(, -widget->height());
             }

             if (rect.contains(QPoint(, wRect.top())) == false)
             {
                 wRect.translate(, widget->height());
             }
         }

         return wRect.topLeft();
     }

在接受到QEvent：：Show这个消息的时候，我们把窗口移动到正确的位置，这样一个完美的右键菜单就完成啦。

二、托盘信息

说到托盘信息，那么就得说说NOTIFYICONDATA这个结构，这个结构中保存了托盘的基本信息，包括托盘图标、托盘tooltip、托盘句柄和托盘关注消息id等一系列成员，这一节Qt之自定义托盘中讲到了怎么创建和删除一个托盘图标，具体的怎么修改其他信息我也在这里大概的说下，因为NOTIFYICONDATA结构的百度百科说的已经非常详细，我在这儿只做大概描述。

1、修改托盘图标

 HICON CSystemTrayIcon::CreateIcon()
 {
     const HICON oldIcon = m_TrayHIcon;
     const QIcon icon = m_TrayIcon;

     if (icon.isNull())
     {
         return oldIcon;
     }
     const int iconSizeX = GetSystemMetrics(SM_CXSMICON);
     const int iconSizeY = GetSystemMetrics(SM_CYSMICON);
     const QSize size = icon.actualSize(QSize(iconSizeX, iconSizeY));
     const QPixmap pm = icon.pixmap(size);
     if (pm.isNull())
     {
         return oldIcon;
     }
     m_TrayHIcon = qt_pixmapToWinHICON(pm);

     return m_TrayHIcon;
 }

 m_NotifyIconData.hIcon = CreateIcon();

         m_ToolTips = QStringLiteral("");

         if (!m_ToolTips.isNull())
             qStringToLimitedWCharArray(m_ToolTips, m_NotifyIconData.szTip, sizeof(m_NotifyIconData.szTip) / sizeof(wchar_t));

 Shell_NotifyIcon(NIM_MODIFY, &m_NotifyIconData);

修改托盘图标主要步骤就是构造NOTIFYICONDATA结构，然后把uFlags设置为NIF_ICON，使hIcon字段有效，我们在讲QImage处理好的图片句柄传递给hIcon，调用Shell_NotifyIcon接口修改托盘。

2、修改托盘tooltips

修改托盘提示信息其实和修改图标是已给道理，首先需要搞清楚修改那个托盘的提示信息，然后在设置uFlags标志，并重置NOTIFYICONDATA结构的具体成员信息，最后调用shell接口修改托盘，代码我就不粘贴了

三、托盘hover窗口

托盘hover时所弹出的框，主要用于显示未接受的消息，可以快速的浏览用户消息，并响应用户的交互，为了和鼠标右键菜单有所区分，在本小节中我把托盘有消息时hover所弹出的界面统称为hover弹框。

1、首先是根据ui设计师的要求，定制好美观的托盘hover弹框，这个弹框一般都包含有消息项，类似于qq的好友消息，这个窗口应该需要支持和我们自定义的托盘类交互的能力，并保持和托盘图标闪烁同步，比较图标闪烁那就说明有消息，进而会出现鼠标hover时，弹出未接消息提示框

2、在托盘菜单发出需要显示hover窗口时，我们把弹框显示出来

3、在第一节菜单内容中，我重点提到了菜单显示位置的问题，hover弹框也存在这个问题，那么我首先先解释下这个hover弹框的规则，我下边的规则都是基于任务栏是在屏幕底下时发生的。

• 托盘图标未在溢出区：hover弹框的中心位置x坐标和托盘图标的中心位置x坐标一样，bottom值和任务栏的top值一样
• 托盘图标在溢出区：hover弹框的中心位置x坐标和托盘图标的中心位置x坐标一样，bottom值和任务栏的top值一样

4、如果任务栏在屏幕的顶部、左侧和右侧，都是类似的处理方式

下边是我自定义窗口的Show函数代码，参数pos是托盘图标的中心位置。

 void CMessagePopupWidget::Show(const QPoint & pos)
 {
     m_TrayIconVerCenter = pos;
     m_CanHide = false;
     QRect wRect = this->rect();
     if (QDesktopWidget * desktop = qApp->desktop())
     {
         QRect rect = desktop->screenGeometry(desktop->primaryScreen());
         wRect.moveTo(m_TrayIconVerCenter);

         switch (MissionToolBar())
         {
         case :
         {
             int missionHeight = MissionToolHeight();
             QPoint pos(wRect.topLeft().x() - wRect.width() / , missionHeight);
             move(pos);
         }
         break;
         case :
         {
             if (rect.contains(QPoint(wRect.right(), )) == false)
             {
                 wRect.translate(-this->width(), );
             }
             QRect r = desktop->availableGeometry(desktop->primaryScreen());
             move(wRect.topLeft() + QPoint(-(m_TrayIconVerCenter.x() - r.width()), -wRect.height() / ));
         }
         break;
         case :
         {
             QRect r = desktop->availableGeometry(desktop->primaryScreen());
             QPoint pos(wRect.topLeft().x() - wRect.width() / , r.height() - wRect.height());
             move(pos);
         }
         break;
         default:
         {
             int missionWidth = MissionToolWidth();
             move(wRect.topLeft() + QPoint(missionWidth - m_TrayIconVerCenter.x(), -wRect.height() / ));
         }
         }
     }

     show();
 }

上边的代码是不是也是不是比较简单啊，呵呵，其实还好。关于上述怎么获取任务栏高度和宽度的方法我就不贴代码了，有兴趣的同学，自行百度。

接下来，我要在补充一下，怎么获取任务栏图标的坐标

1、首先我说下Shell_NotifyIconGetRect这个接口，微软明确说明了这个接口只有在win7后才开始提供，所以如果自定义托盘要在xp系统和win7(win10)系列系统上跑，那么就需要做兼容性处理。

2、下面是一个判断接口，判断指定的动态库是否包含指定接口

 void * common::LibraryContainsInterface(LPWSTR lpDesc, LPCSTR pGuid)
 {
     HINSTANCE hinstLib = ::LoadLibrary(lpDesc);
     if (hinstLib != nullptr)
     {
         void* proc = GetProcAddress(hinstLib, pGuid);
         return proc;
     }
     FreeLibrary(hinstLib);

     return NULL;
 }

3、如果你的系统是win7，包含之后的系统，那么你获取托盘图标的代码看起来像下面这样

 static PtrShell_NotifyIconGetRect Shell_NotifyIconGetRect
         = (PtrShell_NotifyIconGetRect)LibraryContainsInterface(L"shell32", "Shell_NotifyIconGetRect");
     if (Shell_NotifyIconGetRect)
     {
         NOTIFYICONIDENTIFIER notify;
         notify.cbSize = sizeof notify;
         notify.hWnd = (HWND)m_TrayMessageWidget->winId();
         notify.uID = ;
         notify.guidItem = GUID_NULL;

         RECT rect;
         HRESULT hr = Shell_NotifyIconGetRect(&notify, &rect);

         return QRect(rect.left, rect.top, rect.right - rect.left, rect.bottom - rect.top);
     }

4、如果你的系统是xp，或者更早，那么Shell_NotifyIconGetRect这个接口是用不了了，如果使用，直接会导致程序起不来，那么我们的代码会像下边这样

 struct AppData
     {
         HWND hwnd;
         UINT uID;
     };

     QRect ret;

     TBBUTTON buttonData;
     DWORD processID = ;
     HWND trayHandle = FindWindow(L"Shell_TrayWnd", NULL);

     //find the toolbar used in the notification area
     if (trayHandle) {
         trayHandle = FindWindowEx(trayHandle, NULL, L"TrayNotifyWnd", NULL);
         if (trayHandle) {
             HWND hwnd = FindWindowEx(trayHandle, NULL, L"SysPager", NULL);
             if (hwnd) {
                 hwnd = FindWindowEx(hwnd, NULL, L"ToolbarWindow32", NULL);
                 if (hwnd)
                     trayHandle = hwnd;
             }
         }
     }

     if (!trayHandle)
         return ret;

     GetWindowThreadProcessId(trayHandle, &processID);
     if (processID <= )
         return ret;

     HANDLE trayProcess = OpenProcess(PROCESS_VM_OPERATION | PROCESS_VM_READ, , processID);
     if (!trayProcess)
         return ret;

     int buttonCount = SendMessage(trayHandle, TB_BUTTONCOUNT, , );
     LPVOID data = VirtualAllocEx(trayProcess, NULL, sizeof(TBBUTTON), MEM_COMMIT, PAGE_READWRITE);

     if (buttonCount <  || !data) {
         CloseHandle(trayProcess);
         return ret;
     }

     //search for our icon among all toolbar buttons
     for (int toolbarButton = ; toolbarButton < buttonCount; ++toolbarButton) {
         SIZE_T numBytes = ;
         AppData appData = { ,  };
         SendMessage(trayHandle, TB_GETBUTTON, toolbarButton, (LPARAM)data);

         if (!ReadProcessMemory(trayProcess, data, &buttonData, sizeof(TBBUTTON), &numBytes))
             continue;

         if (!ReadProcessMemory(trayProcess, (LPVOID)buttonData.dwData, &appData, sizeof(AppData), &numBytes))
             continue;

         bool isHidden = buttonData.fsState & TBSTATE_HIDDEN;

         if (m_NotifyIconData.hWnd == appData.hwnd && appData.uID == m_NotifyIconData.uID && !isHidden) {
             SendMessage(trayHandle, TB_GETITEMRECT, toolbarButton, (LPARAM)data);
             RECT iconRect = { , , ,  };
             if (ReadProcessMemory(trayProcess, data, &iconRect, sizeof(RECT), &numBytes)) {
                 MapWindowPoints(trayHandle, NULL, (LPPOINT)&iconRect, );
                 QRect geometry(iconRect.left + , iconRect.top + ,
                     iconRect.right - iconRect.left - ,
                     iconRect.bottom - iconRect.top - );
                 if (geometry.isValid())
                     ret = geometry;
                 break;
             }
         }
     }
     VirtualFreeEx(trayProcess, data, , MEM_RELEASE);
     CloseHandle(trayProcess);

以上代码我是在xp、win7和iwn10上测试通过的，没有问题。这篇文章我也没有提供demo，最近实在是太忙了，根本没有时间整理，记录这些的原因也是想整理下思路，并且想帮助一些有问题的同学。文章看到这里，实现一个自定义的托盘逻辑基本上都走通了，剩下的就是qwidget的大量应用，还有界面美化工作啦。

如果您觉得文章不错，不妨给个打赏，写作不易，感谢各位的支持。您的支持是我最大的动力，谢谢！！！ 

---

 

---

很重要--转载声明

1. 本站文章无特别说明，皆为原创，版权所有，转载时请用链接的方式，给出原文出处。同时写上原作者：朝十晚八 or Twowords
2. 如要转载，请原文转载，如在转载时修改本文，请事先告知，谢绝在转载时通过修改本文达到有利于转载者的目的。

---

奋斗中的无名小卒。。。