如何在Windows系统下修改Qt QTabWidget标签的背景色？

环境 #

• Ubuntu 18.04（Qt 6.2.2、Qt Creator 6.0.1）：功能正常，标签显示自定义背景色
• Windows 10（相同Qt版本）：自定义背景色不生效

现有实现 #

通过子类化QTabBar和QTabWidget，重写QTabBar::paintEvent根据标签文本设置对应调色板颜色，将QTabWidget提升为自定义类OzelTabWidget，代码如下：

#ifndef OZELTABWIDGET_H
#define OZELTABWIDGET_H

#include <QStyleOptionTab>
#include <QStylePainter>
#include <QTabWidget>

class OzelTabBar : public QTabBar {
public:
  OzelTabBar(const QHash<QString, QColor> &colors, QWidget *parent = 0)
      : QTabBar(parent) {
    mColors = colors;
  }

protected:
  void paintEvent(QPaintEvent * /*event*/) {

    QStylePainter painter(this);
    QStyleOptionTab opt;    

    for (int i = 0; i < count(); i++) {
      initStyleOption(&opt, i);
      if (mColors.contains(opt.text)) {
        opt.palette.setColor(QPalette::Button, mColors[opt.text]);
      }

      painter.drawControl(QStyle::CE_TabBarTabShape, opt);
      painter.drawControl(QStyle::CE_TabBarTabLabel, opt);
    }    

  }

private:
  QHash<QString, QColor> mColors;
};

class OzelTabWidget : public QTabWidget {
public:
  OzelTabWidget(QWidget *parent = 0) : QTabWidget(parent) {
    QHash<QString, QColor> SideTab;

    SideTab["Main"]      = QColor("yellow");
    SideTab["Settings"]  = QColor("cornflowerblue");
    SideTab["Account"]   = QColor("blue");
    SideTab["Server"]    = QColor("gray");
    SideTab["Records"]   = QColor("magenta");
    SideTab["Preset"]    = QColor("cyan");
    SideTab["Test"]      = QColor("red");

    setTabBar(new OzelTabBar(SideTab));
  }
};

#endif // OZELTABWIDGET_H

解决方案 #

问题根源是Windows平台的Qt默认样式（如WindowsVistaStyle）不会完全遵循QPalette::Button的颜色设置绘制标签背景，而是依赖系统主题逻辑。以下是两种可行修复方式：

方法1：手动绘制标签背景（兼容性更强） #

直接在paintEvent中绘制标签背景矩形，绕过系统样式的背景渲染逻辑：

void paintEvent(QPaintEvent * /*event*/) {
    QStylePainter painter(this);
    QStyleOptionTab opt;    

    for (int i = 0; i < count(); i++) {
        initStyleOption(&opt, i);
        
        // 获取标签区域并微调，避免覆盖边框
        QRect tabRect = tabRect(i);
        tabRect.adjust(1, 1, -1, -1);
        
        if (mColors.contains(opt.text)) {
            QColor tabColor = mColors[opt.text];
            // 绘制自定义背景
            painter.fillRect(tabRect, tabColor);
            // 自动调整文本颜色，确保背景深浅都能看清文字
            opt.palette.setColor(QPalette::ButtonText, 
                tabColor.lightness() < 128 ? Qt::white : Qt::black);
        }

        painter.drawControl(QStyle::CE_TabBarTabShape, opt);
        painter.drawControl(QStyle::CE_TabBarTabLabel, opt);
    }    
}

方法2：扩展调色板设置 #

针对Windows样式的调色板依赖，补充设置更多颜色角色：

void paintEvent(QPaintEvent * /*event*/) {
    QStylePainter painter(this);
    QStyleOptionTab opt;    

    for (int i = 0; i < count(); i++) {
        initStyleOption(&opt, i);
        if (mColors.contains(opt.text)) {
            QColor tabColor = mColors[opt.text];
            // 覆盖多个可能被样式使用的调色板角色
            opt.palette.setColor(QPalette::Button, tabColor);
            opt.palette.setColor(QPalette::Window, tabColor);
            opt.palette.setColor(QPalette::Base, tabColor);
        }

        painter.drawControl(QStyle::CE_TabBarTabShape, opt);
        painter.drawControl(QStyle::CE_TabBarTabLabel, opt);
    }    
}

额外注意事项 #

• 在Windows环境下修改代码后，需清理构建缓存并重新编译项目。
• 方法1的手动绘制方式兼容更多Qt样式（如Fusion），推荐优先使用。

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