如何修改Qt中QPushButton图标On（开启）状态的显示颜色？

你遇到的问题由两个常见Qt开发坑导致：

1. 复用原有QIcon对象时，旧图标内部已缓存的状态条目优先级高于后续新增的条目，你新添加的QIcon::On状态配置被原有配置覆盖，无法生效
2. 部分Qt版本的Fusion风格对可勾选QPushButton的图标状态映射存在偏差，checked状态切换时不会主动触发图标状态刷新

修复步骤 #

1. 不再复用原有QIcon对象，直接基于原图标提取的基础pixmap创建全新的QIcon实例，避免旧缓存干扰
2. 给可勾选按钮绑定toggled信号，状态切换时强制触发重绘
3. 显式声明所有状态的图标配置，避免fallback逻辑异常

修改后的实现代码如下：

#include "mainwindow.h"

MainWindow::MainWindow(QWidget* parent)
    : QMainWindow(parent)
{
    qApp->setStyle(QStyleFactory::create("Fusion"));
    ui.setupUi(this);
    QWidgetList allWidgets = qApp->allWidgets();
    for (QWidget* wid : allWidgets) {
        QString str = wid->metaObject()->className();
        if (str == "QPushButton") {
            auto btn = dynamic_cast<QPushButton*>(wid);
            if (!btn->icon().isNull()) {
                // 只提取原图标Normal/Off状态的基础pixmap
                QPixmap basePix = btn->icon().pixmap(QSize(1024, 1024), QIcon::Normal, QIcon::Off);

                // 生成四个状态的染色pixmap
                QPixmap pixOff = basePix.copy();
                QPainter paintOff(&pixOff);
                paintOff.setCompositionMode(QPainter::CompositionMode_SourceIn);
                paintOff.fillRect(pixOff.rect(), Qt::green);
                paintOff.end();

                QPixmap pixOn = basePix.copy();
                QPainter paintOn(&pixOn);
                paintOn.setCompositionMode(QPainter::CompositionMode_SourceIn);
                paintOn.fillRect(pixOn.rect(), Qt::red);
                paintOn.end();

                QPixmap pixDisOff = basePix.copy();
                QPainter paintDisOff(&pixDisOff);
                paintDisOff.setCompositionMode(QPainter::CompositionMode_SourceIn);
                paintDisOff.fillRect(pixDisOff.rect(), Qt::yellow);
                paintDisOff.end();

                QPixmap pixDisOn = basePix.copy();
                QPainter paintDisOn(&pixDisOn);
                paintDisOn.setCompositionMode(QPainter::CompositionMode_SourceIn);
                paintDisOn.fillRect(pixDisOn.rect(), Qt::blue);
                paintDisOn.end();

                // 创建全新的QIcon，避免旧缓存
                QIcon newIcon;
                newIcon.addPixmap(pixOff, QIcon::Normal, QIcon::Off);
                newIcon.addPixmap(pixDisOff, QIcon::Disabled, QIcon::Off);
                newIcon.addPixmap(pixOff, QIcon::Active, QIcon::Off);
                newIcon.addPixmap(pixOff, QIcon::Selected, QIcon::Off);
                newIcon.addPixmap(pixOn, QIcon::Normal, QIcon::On);
                newIcon.addPixmap(pixDisOn, QIcon::Disabled, QIcon::On);
                newIcon.addPixmap(pixOn, QIcon::Active, QIcon::On);
                newIcon.addPixmap(pixOn, QIcon::Selected, QIcon::On);

                btn->setIcon(newIcon);
                // 可勾选按钮绑定状态切换信号，强制刷新
                if(btn->isCheckable()) {
                    connect(btn, &QPushButton::toggled, btn, QOverload<>::of(&QPushButton::update));
                }
            }
        }
    }
}

额外优化建议 #

如果修改后禁用状态黄色辨识度较低，可以调整染色逻辑，给禁用状态图标增加10%~20%的透明度，或者直接更换对比度更高的暗黄色/橙色。
如果仍然存在状态不生效的问题，可以升级到Qt 5.15以上版本，该版本对Fusion风格的图标状态映射逻辑做了统一修复。

内容的提问来源于stack exchange，提问作者Chaitanya