如何使用Qt实现应用最小化时在图标上激活信息徽章角标

这个功能没有全平台通用的Qt原生接口，需要针对不同运行平台做适配，整体逻辑分为两步：先准确识别窗口最小化状态，再调用对应平台的系统接口在任务栏图标上叠加提示徽章。

前置逻辑：最小化状态检测 #

直接用QWidget自带的状态检测能力即可，不需要额外写系统相关代码：

• 重写主窗口的changeEvent方法，捕获窗口状态变更事件，判断当前是否处于最小化状态
• 也可以连接QWindow::windowStateChanged信号做状态触发，不需要重写事件
  参考实现代码：

void MainWindow::changeEvent(QEvent *e)
{
    if (e->type() == QEvent::WindowStateChange) {
        if (isMinimized() || !isActiveWindow()) {
            // 最小化/窗口失焦时，根据当前未读消息数更新徽章
            updateTaskbarBadge(m_unreadCount);
        } else {
            // 窗口恢复激活状态时，清空未读计数、移除徽章
            m_unreadCount = 0;
            updateTaskbarBadge(0);
        }
    }
    QMainWindow::changeEvent(e);
}

从BUS总线收到新消息时，先判断窗口状态：如果窗口在前台激活就直接处理消息，不触发徽章更新；如果窗口最小化/在后台就累加未读计数，调用徽章更新函数。

分平台徽章实现 #

Windows平台（Win7及以上） #

直接用Qt WinExtras模块提供的QWinTaskbarButton类即可，不需要手写Win32 COM接口：

1. 项目配置文件里引入模块：QT += winextras
2. 等窗口句柄创建完成后（建议在首次showEvent中执行）初始化任务栏按钮实例，绑定当前窗口
3. 动态绘制带数字的徽章图标，通过setOverlayIcon接口设置到任务栏按钮上，传入空图标即可清除徽章
   参考实现：

// 主窗口类成员变量声明：QWinTaskbarButton *m_taskbarBtn = nullptr;
void MainWindow::showEvent(QShowEvent *e)
{
    QMainWindow::showEvent(e);
#ifdef Q_OS_WIN
    if (!m_taskbarBtn) {
        m_taskbarBtn = new QWinTaskbarButton(this);
        m_taskbarBtn->setWindow(windowHandle());
    }
#endif
}

void MainWindow::updateTaskbarBadge(int count)
{
#ifdef Q_OS_WIN
    if (!m_taskbarBtn) return;
    if (count == 0) {
        m_taskbarBtn->setOverlayIcon(QIcon());
        return;
    }
    // 动态绘制红底白字的圆形徽章
    QPixmap badgePix(32, 32);
    badgePix.fill(Qt::transparent);
    QPainter p(&badgePix);
    p.setRenderHint(QPainter::Antialiasing);
    p.setBrush(Qt::red);
    p.setPen(Qt::NoPen);
    p.drawEllipse(2, 2, 28, 28);
    p.setPen(Qt::white);
    p.setFont(QFont("Microsoft Yahei", 14, QFont::Bold));
    QString showText = count > 99 ? "99+" : QString::number(count);
    p.drawText(badgePix.rect(), Qt::AlignCenter, showText);
    m_taskbarBtn->setOverlayIcon(QIcon(badgePix));
#endif
}

踩坑提示：不要在主窗口构造函数里绑定windowHandle，此时窗口句柄还未创建，会导致徽章完全不显示。

macOS平台 #

macOS的Dock栏徽章有系统原生接口，通过Objective-C++混编即可调用，不需要自己绘制图标：

1. 将对应实现文件的后缀从.cpp改为.mm，启用Objective-C++编译支持
2. 项目配置里追加系统框架依赖：LIBS += -framework AppKit
3. 直接给Dock栏Tile设置badge文本即可，系统会自动渲染成标准样式
   参考实现：

#ifdef Q_OS_MACOS
#import <AppKit/AppKit.h>
void MainWindow::updateTaskbarBadge(int count)
{
    if (count == 0) {
        [NSApp dockTile].badgeLabel = nil;
        return;
    }
    NSString *badgeText = count > 99 ? @"99+" : [NSString stringWithFormat:@"%d", count];
    [NSApp dockTile].badgeLabel = badgeText;
}
#endif

Linux平台 #

Linux桌面环境碎片化严重，GNOME、KDE、XFCE、DDE等不同桌面的任务栏接口不统一，没有覆盖全场景的窗口图标徽章方案：

• 对于支持Unity Launcher API的桌面（Ubuntu默认GNOME、旧版Unity等），可以通过D-Bus调用对应接口设置徽章
• 兼容性最高的方案是直接用QSystemTrayIcon创建系统托盘图标，在托盘图标上叠加绘制徽章，所有Linux桌面都能支持，实现逻辑和Windows下动态绘制徽章的逻辑完全一致。

优化建议 #

• 徽章显示的数字最大不要超过2位，超过99统一显示99+，避免内容溢出图标范围
• 不要每次收到BUS消息都重绘徽章，等未读计数变化时再触发更新，减少不必要的性能消耗
• 如果需要兼容Windows XP等极老系统，需要手动调用ITaskbarList3的COM接口实现，目前绝大多数场景不需要做这个兼容。

内容的提问来源于stack exchange，提问作者R. Alaie