为QWidget窗口添加QGraphicsBlurEffect后背景全黑的技术咨询

问题原因 #

顶层QWidget默认没有填充背景内容，当为其添加QGraphicsBlurEffect时，模糊效果作用于空的绘制区域，Qt的图形效果渲染机制会将未填充的透明区域处理为黑色，最终导致窗口背景变黑。

另外，调整窗口时出现的渲染异常（绿色区域/边缘痕迹），是因为QGraphicsBlurEffect会在Widget的原始绘制区域外生成模糊边缘，若Widget没有预留足够空间容纳这些边缘，就会显示底层窗口的颜色；同时重绘时的同步延迟也会导致短暂的内容错位。

解决方案 #

方案1：为顶层QWidget设置可模糊的背景 #

给顶层窗口设置明确的背景（纯色、渐变或半透明），让模糊效果有可作用的内容：

#include <QGraphicsBlurEffect>
#include <QApplication>
#include <QWidget>
#include <QLabel>

int main(int argc, char** argv) {
    QApplication app(argc,argv);
    QWidget window;
    // 设置窗口背景为浅灰色，提供模糊效果的基础内容
    window.setStyleSheet("QWidget { background-color: #f0f0f0; }");
    
    auto blur = new QGraphicsBlurEffect;
    blur->setBlurRadius(10); // 按需调整模糊程度
    window.setGraphicsEffect(blur);
    
    QLabel* label = new QLabel("Hello World.", &window);
    label->setStyleSheet("color: white; font-size: 20px;");
    label->move(50,50);
    
    window.resize(400,300);
    window.show();
    return app.exec();
}

方案2：将模糊效果应用于子Widget而非顶层窗口 #

更合理的做法是保持顶层窗口的正常背景，仅对内部需要模糊的子Widget添加效果，避免和窗口管理器的绘制逻辑冲突：

#include <QGraphicsBlurEffect>
#include <QApplication>
#include <QWidget>
#include <QLabel>

int main(int argc, char** argv) {
    QApplication app(argc,argv);
    QWidget window;
    window.setStyleSheet("QWidget { background-color: #f0f0f0; }");
    
    QWidget* blurContainer = new QWidget(&window);
    blurContainer->setGeometry(50,50,300,200);
    // 给子Widget设置半透明背景，模糊后效果更自然
    blurContainer->setStyleSheet("background-color: rgba(255,255,255,0.8);");
    
    auto blur = new QGraphicsBlurEffect;
    blur->setBlurRadius(10);
    blurContainer->setGraphicsEffect(blur);
    
    QLabel* label = new QLabel("Hello World.", blurContainer);
    label->setStyleSheet("color: black; font-size: 20px;");
    label->move(80,80);
    
    window.resize(400,300);
    window.show();
    return app.exec();
}

渲染异常的额外处理 #

针对调整窗口时的边缘痕迹问题：

• 给添加模糊效果的Widget设置margin，预留模糊边缘的空间，比如在样式表中添加margin: 5px;（值大于等于模糊半径的一半）
• 调用blur->setOffset(0,0)确保效果对齐Widget边界
• 启用widget->setAttribute(Qt::WA_OpaquePaintEvent)减少透明区域的绘制冲突

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