如何在MacOSX Monterey下为Qt QComboBox设色并保留系统样式？

问题背景 #

在MacOSX 12.4（Monterey）系统上使用Qt 5.15.3开发时，遇到QComboBox和QPushButton的颜色定制难题：

• 直接用调色板仅能修改下拉列表未选中项的颜色，控件主体样式无变化；
• 使用样式表修改颜色会丢失系统原生样式，控件变成老旧的非Mac风格；
• 尝试过重置系统样式、单独设置控件调色板等操作均无效。

已尝试的代码 #

QPalette pal = qApp->palette();
pal.setColor(QPalette::Window, Qt::black);
pal.setColor(QPalette::WindowText, Qt::white);
pal.setColor(QPalette::Text, Qt::white);
pal.setColor(QPalette::ButtonText, Qt::white);
pal.setColor(QPalette::Button, Qt::darkGray);
pal.setColor(QPalette::Base, Qt::darkGray);
pal.setColor(QPalette::AlternateBase, Qt::gray);
pal.setColor(QPalette::Light, Qt::white);
pal.setColor(QPalette::Midlight,Qt::gray);
pal.setColor(QPalette::Dark, Qt::darkGray);
qApp->setPalette(pal);

// qApp->setStyleSheet("QComboBox { background-color: gray}"); // 能改颜色但丢失系统样式
// ui->comboBox->setStyleSheet("border:none"); // 同样丢失系统样式
// ui->comboBox->setStyle(QStyleFactory::create("Macintosh")); // 无效果，仍显示类似Windows的样式
// ui->comboBox->setAutoFillBackground(true); // 仅在控件后方填充颜色

// ui->comboBox->setPalette(pal); // 无任何变化
// ui->comboBox->setBackgroundRole(QPalette::Base); // 无任何变化

可行解决方法 #

方法1：子类化QMacStyle自定义样式 #

Qt的QMacStyle是Mac系统样式的实现类，子类化它并重写调色板处理方法，可在保留原生绘制逻辑的前提下替换指定颜色：

#include <QMacStyle>

class CustomMacStyle : public QMacStyle
{
    Q_OBJECT
public:
    explicit CustomMacStyle(QObject *parent = nullptr) : QMacStyle(parent) {}

    void polish(QPalette &palette) override {
        // 修改目标颜色，保留其他原生调色板属性
        palette.setColor(QPalette::Window, Qt::black);
        palette.setColor(QPalette::WindowText, Qt::white);
        palette.setColor(QPalette::Button, Qt::darkGray);
        palette.setColor(QPalette::ButtonText, Qt::white);
        QMacStyle::polish(palette);
    }

    void polish(QWidget *widget) override {
        // 针对QComboBox做额外调色板设置
        if (qobject_cast<QComboBox*>(widget)) {
            widget->setAutoFillBackground(true);
            QPalette pal = widget->palette();
            pal.setColor(QPalette::Base, Qt::darkGray);
            widget->setPalette(pal);
        }
        QMacStyle::polish(widget);
    }
};

// 在main函数中启用自定义样式
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    a.setStyle(new CustomMacStyle);
    // ...
    return a.exec();
}

这种方式能完整保留Mac原生控件的交互细节和视觉风格，仅替换需要的颜色属性。

方法2：拆分控件部分单独处理 #

QComboBox由输入区域、下拉按钮和下拉列表三个独立部分组成，可分别设置调色板和轻量样式表：

// 处理下拉列表的颜色
QAbstractItemView *dropView = ui->comboBox->view();
QPalette viewPal = dropView->palette();
viewPal.setColor(QPalette::Base, Qt::darkGray);
viewPal.setColor(QPalette::Text, Qt::white);
dropView->setPalette(viewPal);

// 针对控件主体使用不破坏原生样式的轻量样式表
// 仅修改颜色，避免修改border、background-image等覆盖原生样式的属性
ui->comboBox->setStyleSheet("QComboBox { color: white; } QComboBox::drop-down { border: none; }");

// 对QPushButton做类似处理
ui->pushButton->setStyleSheet("QPushButton { color: white; background-color: transparent; }");

这种方式兼顾系统样式和颜色修改，适合局部调整需求。

方法3：适配系统深色模式 #

如果需求是实现深色模式适配，可直接让Qt跟随系统配色逻辑：

// 在main函数中配置
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
#if (QT_VERSION >= QT_VERSION_CHECK(5, 14, 0))
    a.setStyle(QStyleFactory::create("Macintosh"));
    // 配置深色模式调色板
    QPalette darkPal = a.palette();
    darkPal.setColor(QPalette::Window, QColor(30, 30, 30));
    darkPal.setColor(QPalette::WindowText, Qt::white);
    darkPal.setColor(QPalette::Base, QColor(40, 40, 40));
    darkPal.setColor(QPalette::Text, Qt::white);
    darkPal.setColor(QPalette::Button, QColor(50, 50, 50));
    darkPal.setColor(QPalette::ButtonText, Qt::white);
    a.setPalette(darkPal);
#endif
    // ...
    return a.exec();
}

这种方式完全复用系统原生控件样式，适合全局深色模式适配场景。

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