Qt6中QPushButton背景色不受alpha值影响始终一致的问题

我正在开发一款应用，尝试为QPushButton设置自定义颜色，示例代码如下：

C++代码 #

#include <QApplication>
#include <QMainWindow>
#include <QPushButton>

int
main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    auto* const mainWindow = new QMainWindow;

    auto* const pushButton = new QPushButton("Click me!");

    auto palette = QPalette();
    palette.setColor(QPalette::Button, QColor(255, 0, 0, 50));
    pushButton->setAutoFillBackground(true);
    pushButton->setPalette(palette);

    mainWindow->setCentralWidget(pushButton);
    mainWindow->show();

    return app.exec();
}

CMakeLists.txt #

cmake_minimum_required(VERSION 3.8)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)

project(ExampleProject LANGUAGES CXX)

find_package(QT NAMES Qt5 COMPONENTS Widgets REQUIRED)
find_package(Qt5 COMPONENTS Widgets REQUIRED)

add_executable(ExampleProject
    ${CMAKE_CURRENT_LIST_DIR}/main.cpp
)

target_link_libraries(ExampleProject
    PRIVATE Qt::Widgets
)

上述示例中为按钮设置了低透明度的红色，使用Qt5编译时界面正常，调整alpha值可见效果；但使用Qt6编译时，按钮颜色为预期红色，但渲染的透明度始终为最大值，修改alpha值无法改变视觉效果。

请问我是否错误使用了QPalette实例？或是Qt5到Qt6之间调色板处理逻辑有变化？亦或是这可能是一个bug？

环境：Qt 5.15/6.2、KDE Plasma 5.27

问题原因及解决方案 #

原因分析 #

这不是你对QPalette的错误使用，而是Qt5到Qt6在控件背景渲染逻辑上的变化，同时受桌面环境样式（比如KDE Plasma的Breeze样式）影响：

• Qt6中，部分原生样式会忽略QPalette中颜色的alpha通道，强制使用不透明的背景绘制逻辑，以保持样式一致性；
• Qt6对setAutoFillBackground的处理逻辑有调整，部分场景下该属性无法触发带透明度的背景填充。

解决方案 #

方案1：使用Qt样式表（QSS）替代QPalette

QSS的透明度处理在Qt5和Qt6中表现更一致，修改按钮背景色的代码如下：

pushButton->setStyleSheet("QPushButton { background-color: rgba(255, 0, 0, 50); }");

注意：如果需要保留原样式的其他效果，可以针对性地只覆盖背景色，或者结合样式继承。

方案2：自定义按钮绘制

如果需要更精细的控制，可以继承QPushButton重写paintEvent，手动绘制带透明度的背景：

class TransparentButton : public QPushButton
{
public:
    using QPushButton::QPushButton;

protected:
    void paintEvent(QPaintEvent* event) override
    {
        QPainter painter(this);
        // 绘制带透明度的背景
        painter.fillRect(rect(), QColor(255, 0, 0, 50));
        // 绘制按钮文本和其他元素
        QPushButton::paintEvent(event);
    }
};

然后使用TransparentButton替代原QPushButton即可。

方案3：调整Qt样式属性

可以尝试禁用样式的背景优化，强制使用自定义调色板：

pushButton->setAttribute(Qt::WA_StyledBackground, true);

这个属性会让控件使用Qt的通用样式绘制逻辑，而非原生桌面样式，可能会解决透明度失效问题，但可能会改变按钮的其他视觉效果。

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