如何设置QComboBox菜单背景透明并消除弹出时短暂黑底？

我尝试创建一个包含弹出菜单的圆角边框QComboBox，但设置border-radius后样式并未应用到背景上：

查找解决方案时，我找到了移除背景的方法，但应用后弹出菜单会短暂显示黑色背景：

复现代码 #

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    ui.setupUi(this);

    QComboBox* comboBox = new QComboBox(this);
    
    comboBox->setStyleSheet(R"(
        QComboBox  {
            border-radius: 8px;
            margin: 10px;
            background-color: gray;
            min-height: 32px;
        }
    
        QComboBox QAbstractItemView {
            border-radius: 8px;
            margin: 10px;
            background-color: gray;
        }
    )");
    
    comboBox->move(100, 100);
    comboBox->addItem("1");
    comboBox->addItem("2");
    
    comboBox->view()->window()->setWindowFlags( Qt::Popup | Qt::FramelessWindowHint |Qt::NoDropShadowWindowHint);
    comboBox->view()->window()->setAttribute(Qt::WA_TranslucentBackground);
}

我尝试过但无效的方法 #

if (comboBox->view()->parentWidget())
{
    auto p = comboBox->view()->parentWidget();
    p->setWindowOpacity(0);
    p->setWindowFlags( Qt::Popup | Qt::FramelessWindowHint |Qt::NoDropShadowWindowHint);
    p->setAttribute(Qt::WA_TranslucentBackground);
    p->setHidden(true);
    p->setAutoFillBackground( false );
}

comboBox->setAutoFillBackground( false );
comboBox->view()->setAutoFillBackground( false );
comboBox->view()->viewport()->setAutoFillBackground(false);
comboBox->view()->window()->setAutoFillBackground(false);

//comboBox->view()->setAttribute(Qt::WA_TranslucentBackground);
//comboBox->view()->viewport()->setAttribute(Qt::WA_TranslucentBackground);
//comboBox->view()->window()->setAttribute(Qt::WA_TranslucentBackground);

comboBox->view()->setWindowOpacity(0);
comboBox->view()->viewport()->setWindowOpacity(0);
comboBox->view()->window()->setWindowOpacity(0);

//comboBox->view()->setHidden(true);
//comboBox->view()->viewport()->setHidden(true);
//comboBox->view()->window()->setHidden(true);

QPalette palette = comboBox->view()->palette();
palette.setColor(QPalette::Window, Qt::transparent);
comboBox->view()->setPalette(palette);

解决方案 #

问题根源是弹出窗口初始化绘制时，默认背景色未被正确覆盖，加上WA_TranslucentBackground后，未初始化区域会显示黑色。可以通过以下两步解决：

1. 完善样式表，覆盖视图视口背景 #

修改QAbstractItemView的样式，同时给viewport设置背景色，确保绘制区域完全覆盖：

QComboBox {
    border-radius: 8px;
    margin: 10px;
    background-color: gray;
    min-height: 32px;
}

QComboBox QAbstractItemView {
    border-radius: 8px;
    margin: 10px;
    background-color: transparent;
    border: none;
}

QComboBox QAbstractItemView::viewport {
    background-color: gray;
    border-radius: 8px;
}

2. 正确设置弹出窗口属性，避免绘制闪烁 #

不要直接修改view的window属性，而是通过重写QComboBox的showPopup方法，在弹出窗口显示前设置属性，确保初始化时就应用透明背景：

#include <QComboBox>
#include <QWidget>

class CustomComboBox : public QComboBox
{
protected:
    void showPopup() override
    {
        QComboBox::showPopup();
        // 找到弹出窗口容器
        QWidget* popupContainer = this->findChild<QWidget*>("qt_scrollarea_container");
        if (popupContainer) {
            popupContainer->setWindowFlags(popupContainer->windowFlags() | Qt::FramelessWindowHint | Qt::NoDropShadowWindowHint);
            popupContainer->setAttribute(Qt::WA_TranslucentBackground);
            // 强制刷新避免闪烁
            popupContainer->update();
        }
    }
};

使用示例 #

替换原代码中的QComboBox为CustomComboBox：

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    ui.setupUi(this);

    CustomComboBox* comboBox = new CustomComboBox(this);
    
    comboBox->setStyleSheet(R"(
        QComboBox {
            border-radius: 8px;
            margin: 10px;
            background-color: gray;
            min-height: 32px;
        }

        QComboBox QAbstractItemView {
            border-radius: 8px;
            margin: 10px;
            background-color: transparent;
            border: none;
        }

        QComboBox QAbstractItemView::viewport {
            background-color: gray;
            border-radius: 8px;
        }
    )");
    
    comboBox->move(100, 100);
    comboBox->addItem("1");
    comboBox->addItem("2");
}

这样修改后，弹出菜单的黑色闪烁会被完全消除，同时保持圆角样式的一致性。

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