C++学习之路（十七）C++ 用Qt5实现一个工具箱（增加托盘图标并且增加显示和退出菜单）- 示例代码拆分讲解
上篇文章，我们用 Qt5 实现了在小工具箱中添加了《为屏幕颜色提取功能增加一个点击复制的功能》功能。今天我们增加一个比较正式点的功能，就是增加托盘图标并且增加显示和退出菜单（越来越像回事了吧 ）。下面我们就来看看如何来规划开发这样的小功能并且添加到我们的工具箱中吧。
老规矩，先上图
需求功能概述：
-
系统托盘图标的创建：
- 使用
QSystemTrayIcon类创建了一个系统托盘图标。 - 图标加载了指定路径下的图标文件，并设置了工具提示信息。
- 使用
-
托盘菜单的实现：
- 创建了一个托盘菜单 (
QMenu) 用于托盘图标右键点击时弹出。 - 托盘菜单包括了两个选项：显示面板和退出应用程序。
- 创建了一个托盘菜单 (
-
主窗口的显示与隐藏：
- 实现了
MyMainWindow类，重写了关闭事件处理函数，在关闭窗口时隐藏窗口而不是退出应用程序。 - 创建了一个
showPanel()槽函数，在点击托盘菜单的 “显示面板” 选项时显示主窗口并将其置于其他窗口之上。
- 实现了
功能实现细节：
MyMainWindow类中的closeEvent函数重写，用于控制关闭窗口的行为，实现隐藏窗口而非退出程序。showPanel()槽函数负责显示主窗口并将其置于其他窗口之上。- 创建了两个菜单选项：一个用于显示主窗口，另一个用于退出应用程序。
- 使用
QAction将触发事件与特定功能（如显示主窗口、退出程序）连接起来。
这些功能集合起来，使得应用程序在系统托盘中可以通过右键点击托盘图标，显示主窗口或退出应用程序，同时在关闭窗口时隐藏而非退出应用程序。
核心实现代码：
class MyMainWindow : public QWidget {
Q_OBJECT
public:
explicit MyMainWindow(QWidget *parent = nullptr) : QWidget(parent) {
// ...
}
protected:
// 重写关闭事件处理函数
void closeEvent(QCloseEvent *event) override {
if (this->isVisible()) {
// 隐藏主窗口，而不是退出程序
this->hide();
event->ignore(); // 忽略关闭事件，防止程序退出
}
}
public slots:
// ...
void showPanel() {
this->show(); // 显示主窗口
this->raise(); // 将窗口置于其他窗口上方
}
private:
// ...
};
int main(int argc, char *argv[]) {
// ...
// 创建托盘图标
auto* trayIcon = new QSystemTrayIcon(QIcon(":/res/icon/logo.png"), &mainWindow);
trayIcon->setToolTip("My App Tray Icon");
// 创建托盘菜单
auto* trayMenu = new QMenu(&mainWindow);
auto* showPanelAction = new QAction("显示面板", &mainWindow);
QObject::connect(showPanelAction, &QAction::triggered, &mainWindow, &MyMainWindow::showPanel);
trayMenu->addAction(showPanelAction);
auto* quitAction = new QAction("退出", &mainWindow);
QObject::connect(quitAction, &QAction::triggered, &a, &QApplication::quit);
trayMenu->addAction(quitAction);
trayIcon->setContextMenu(trayMenu);
trayIcon->show();
// ...
}
核心代码逻辑讲解
让我们逐段分解并解释代码的作用以及各函数的使用：
创建 MyMainWindow 类
class MyMainWindow : public QWidget {
Q_OBJECT
public:
explicit MyMainWindow(QWidget *parent = nullptr) : QWidget(parent) {
// ...
}
protected:
void closeEvent(QCloseEvent *event) override {
if (this->isVisible()) {
this->hide();
event->ignore();
}
}
public slots:
void showPanel() {
this->show();
this->raise();
}
private:
// ...
};
MyMainWindow类：自定义主窗口类，继承自QWidget，重写了关闭事件处理函数closeEvent()，在窗口关闭时隐藏而非退出应用程序。另外，实现了showPanel()槽函数，用于显示主窗口并置于其他窗口之上。
主函数 main
int main(int argc, char *argv[]) {
QApplication a(argc, argv);
// ...
auto* trayIcon = new QSystemTrayIcon(QIcon(":/res/icon/logo.png"), &mainWindow);
trayIcon->setToolTip("My App Tray Icon");
auto* trayMenu = new QMenu(&mainWindow);
auto* showPanelAction = new QAction("显示面板", &mainWindow);
QObject::connect(showPanelAction, &QAction::triggered, &mainWindow, &MyMainWindow::showPanel);
trayMenu->addAction(showPanelAction);
auto* quitAction = new QAction("退出", &mainWindow);
QObject::connect(quitAction, &QAction::triggered, &a, &QApplication::quit);
trayMenu->addAction(quitAction);
trayIcon->setContextMenu(trayMenu);
trayIcon->show();
// ...
return a.exec();
}
main函数：应用程序入口，创建了QApplication实例，并初始化了系统托盘图标、托盘菜单和相关动作。QSystemTrayIcon：创建了一个系统托盘图标对象，并加载了指定图标文件设置了提示信息。QMenu：创建了一个托盘菜单对象，用于托盘图标右键点击时弹出。QAction：创建了两个动作选项并分别与槽函数连接。一个是显示面板 (showPanelAction)，另一个是退出应用程序 (quitAction)。setContextMenu：将托盘菜单设置为系统托盘图标的右键菜单。show()和raise()：显示主窗口并置于其他窗口之上。
这些代码段集合起来，实现了系统托盘图标、菜单和主窗口的显示控制，允许用户通过托盘图标来控制应用程序的行为。
图标资源文件如何添加到项目中?
在Clion中创建的QT5项目，并没有找到所谓的 Qt Creator ，我们可以通过以下办法来使用相对路径引入图片资源。
在 CLion 中创建的 Qt 项目可以使用资源文件（.qrc）来包含图片资源。你可以手动创建 .qrc 文件并将其添加到你的项目中。
以下是一个示例：
-
在项目的根目录（和
main.cpp同级）手动创建一个新的文件，命名为resources.qrc或其他你喜欢的名字。
-
编辑
.qrc文件，添加资源：
DOCTYPE RCC>
<RCC version="1.0">
<qresource>
<file>res/icon/logo.pngfile>
qresource>
RCC>
确保路径 res/icon/logo.png 是相对于 .qrc 文件的路径，以正确地引用图片资源。
- 在
CMakeLists.txt文件中添加.qrc文件到你的项目中：
# 将 resources.qrc 添加到项目中
set(QT_RESOURCES resources.qrc)
# 编译项目时包含生成的资源文件
add_executable(YourProjectName
${QT_RESOURCES}
# ...其他文件...
)
确保将 YourProjectName 替换为你实际的项目名称(也有用 ${PROJECT_NAME}来表示的)，并将 resources.qrc 文件包含到 set() 中。
- 在你的代码中使用资源文件的路径来加载图标：
QSystemTrayIcon* trayIcon = new QSystemTrayIcon(QIcon(":/res/icon/logo.png"), &window);
这样配置后，重新编译你的项目，图标应该能够正确地被加载和显示了。
核心代码讲解完毕，下面是完整版代码，复制到本地跑一跑吧~
#include 资源文件 resources.qrc
DOCTYPE RCC>
<RCC version="1.0">
<qresource>
<file>res/icon/logo.pngfile>
qresource>
RCC>
CMakeLists.txt 文件变更
# 将 resources.qrc 添加到项目中
set(QT_RESOURCES resources.qrc)
add_executable(${PROJECT_NAME} ${QT_RESOURCES} main.cpp)
好了，这次的完整代码就这些了，抓紧动手开始吧~
想要了解这个小工具是如何发展到现在这个地步的话，就看看往期文章吧~，记得要多跑一跑代码。如果大家有什么想要的功能或者想问的问题的话，就在评论区留言吧。Thanks♪(･ω･)ﾉ
往期文章一览
C++学习之路（一）什么是C++？如何循序渐进的学习C++？【纯干货】
C++学习之路（二）C++如何实现一个超简单的学生信息管理系统？C++示例和小项目实例
C++学习之路（三）解析讲解超简单学生信息管理系统代码知识点 - 《根据实例学知识》
C++学习之路（四）C++ 实现简单的待办事项列表命令行应用 - 示例代码拆分讲解
C++学习之路（五）C++ 实现简单的文件管理系统命令行应用 - 示例代码拆分讲解
C++学习之路（六）C++ 实现简单的工具箱系统命令行应用 - 示例代码拆分讲解
C++学习之路（七）C++ 实现简单的Qt界面（消息弹框、按钮点击事件监听）- 示例代码拆分讲解
C++学习之路（八）C++ 用Qt5实现一个工具箱（增加一个粘贴板记录管理功能）- 示例代码拆分讲解
C++学习之路（九）C++ 用Qt5实现一个工具箱（增加一个JSON数据格式化功能）- 示例代码拆分讲解
C++学习之路（十）C++ 用Qt5实现一个工具箱（增加一个时间戳转换功能）- 示例代码拆分讲解
C++学习之路（十一）C++ 用Qt5实现一个工具箱（增加一个进制转换器功能）- 示例代码拆分讲解
C++学习之路（十二）C++ 用Qt5实现一个工具箱（增加一个XML文本格式化功能）- 示例代码拆分讲解
C++学习之路（十三）C++ 用Qt5实现一个工具箱（增加一个Base64加解密功能）- 示例代码拆分讲解
C++学习之路（十四）C++ 用Qt5实现一个工具箱（增加一个Base64图片编码预览功能）- 示例代码拆分讲解
C++学习之路（十五）C++ 用Qt5实现一个工具箱（增加16进制颜色码转换和屏幕颜色提取功能）- 示例代码拆分讲解
C++学习之路（十六）C++ 用Qt5实现一个工具箱（为屏幕颜色提取功能增加一个点击复制的功能）- 示例代码拆分讲解
好了~ 本文就到这里了，感谢您的阅读，每天还有更多的实例学习文章等着你 。别忘了点赞、收藏~ Thanks♪(･ω･)ﾉ 。