【Qt】任务栏图标、托盘图标、应用程序图标

一、核心概念

1. 应用程序图标：.exe文件显示的图标，通过资源文件设置
2. 任务栏图标：窗口标题栏和任务栏显示的图标，通过setWindowIcon()设置
3. 托盘图标：系统托盘区域的图标，使用QSystemTrayIcon实现

二、在 Visual Studio 中实现（使用Qt VS Tools）

步骤1：创建资源文件

1. 右键项目 → 添加 → 新建项 → Qt Resource File（命名为Resources.qrc）
2. 添加图标文件（如app_icon.ico, tray_icon.ico）到项目目录
3. 在Resources.qrc中添加图标：

   <RCC>
     <qresource prefix="/">
       <file>app_icon.ico</file>
       <file>tray_icon.ico</file>
     </qresource>
   </RCC>
   

步骤2：设置应用程序图标

1. 创建app.rc文件：

   IDI_ICON1 ICON DISCARDABLE "app_icon.ico"
   

2. 在项目属性 → 链接器 → 输入 → 附加依赖项：添加app.rc

步骤3：代码实现

#include <QApplication>
#include <QMainWindow>
#include <QSystemTrayIcon>
#include <QMenu>
#include <QAction>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    
    // 设置应用程序图标（任务栏和窗口图标）
    a.setWindowIcon(QIcon(":/app_icon.ico"));

    QMainWindow window;
    window.setWindowTitle("Qt Application");
    window.show();

    // 创建托盘图标
    QSystemTrayIcon trayIcon;
    trayIcon.setIcon(QIcon(":/tray_icon.ico"));
    trayIcon.setToolTip("System Tray Demo");

    // 创建托盘菜单
    QMenu* trayMenu = new QMenu();
    QAction* restoreAction = new QAction("恢复窗口", trayMenu);
    QAction* quitAction = new QAction("退出", trayMenu);
    
    trayMenu->addAction(restoreAction);
    trayMenu->addAction(quitAction);
    trayIcon.setContextMenu(trayMenu);

    // 连接信号
    QObject::connect(restoreAction, &QAction::triggered, [&window]() {
        window.show();
        window.activateWindow();
    });
    QObject::connect(quitAction, &QAction::triggered, &a, &QApplication::quit);
    QObject::connect(&trayIcon, &QSystemTrayIcon::activated, [&window](QSystemTrayIcon::ActivationReason reason) {
        if (reason == QSystemTrayIcon::DoubleClick) window.show();
    });

    trayIcon.show();

    return a.exec();
}

三、在 Qt Creator 中实现

步骤1：添加资源文件

1. 右键项目 → Add New… → Qt → Qt Resource File
2. 添加前缀（如/icons），然后添加图标文件

步骤2：设置应用程序图标

1. 在.pro文件中添加：

   RC_ICONS = app_icon.ico  # 确保文件在项目目录
   

步骤3：代码实现（同VS代码）

将上述代码复制到main.cpp中，注意资源路径：

// Qt Creator中使用资源路径：
a.setWindowIcon(QIcon(":/icons/app_icon.ico")); // 根据实际前缀调整
trayIcon.setIcon(QIcon(":/icons/tray_icon.ico"));

四、关键功能详解

1. 托盘菜单功能：
   • 左键双击：恢复窗口
   • 右键点击：显示菜单（恢复/退出）
2. 窗口最小化到托盘：

   // 在MainWindow类中添加
   void MainWindow::changeEvent(QEvent* event) {
       if (event->type() == QEvent::WindowStateChange && isMinimized()) {
           this->hide(); // 最小化时隐藏窗口
           event->ignore();
       }
   }
   

3. 托盘消息通知：

   trayIcon.showMessage("标题", "消息内容", QSystemTrayIcon::Information, 3000);
   

五、图标制作注意事项

1. 格式：Windows推荐使用.ico（支持多分辨率）
2. 尺寸：
   • 应用图标：16x16, 32x32, 48x48, 256x256
   • 托盘图标：16x16（任务栏）, 24x24（高DPI）

六、常见问题解决

1. 托盘图标不显示：
   • 检查系统托盘是否支持（某些Linux桌面需安装插件）
   • 确保trayIcon.show()被调用
2. 图标显示为默认Qt图标：
   • 检查资源文件路径是否正确
   • 重新运行qmake
3. Windows任务栏图标重叠：

   // 设置应用ID（Windows特有）
   #include <qt_windows.h>
   int main(int argc, char *argv[]) {
       QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
       QApplication a(argc, argv);
       SetCurrentProcessExplicitAppUserModelID(L"YourCompany.YourApp.1.0");
       // ...其他代码
   }
   

最终效果

• 应用程序显示自定义图标
• 窗口任务栏显示设置图标
• 系统托盘显示可交互图标
• 支持最小化到托盘功能

两种开发环境的核心代码一致，主要差异在于资源文件管理和项目配置。

推荐阅读

• C++专栏
• Qt进阶专栏