QWidget 设置背景颜色

在 Qt 框架中为 QWidget 设置背景颜色，可通过以下 5 种方法实现（含全屏场景优化方案）：

---

方法 1：样式表（推荐）

// C++ 示例
widget->setStyleSheet("background-color: #FF0000;"); // 十六进制颜色
// 或
widget->setStyleSheet("background-color: rgb(255, 0, 0);"); // RGB 值

优点：

• 语法简单，支持透明度（rgba(255,0,0,128)）
• 可直接作用于子控件（需设置 QWidget { background-color: ... }）

全屏优化：

// 确保全屏时背景完全填充
widget->setAttribute(Qt::WA_StyledBackground, true);
widget->setStyleSheet("QWidget { background-color: black; }");

---

方法 2：重写 paintEvent

// C++ 自定义控件示例
class CustomWidget : public QWidget {
protected:
    void paintEvent(QPaintEvent*) override {
        QPainter painter(this);
        painter.fillRect(rect(), QColor(255, 0, 0)); // 填充红色
    }
};

优点：

• 支持渐变、图案等复杂绘制
• 性能优于样式表（适合高频更新）

全屏优化：

// 在构造函数中禁用抗锯齿（可选）
setAttribute(Qt::WA_NoSystemBackground, true);
setAttribute(Qt::WA_OpaquePaintEvent, true);

---

方法 3：调色板（Palette）

// C++ 示例
QPalette pal = widget->palette();
pal.setColor(QPalette::Window, Qt::red);
widget->setAutoFillBackground(true); // 关键：启用自动填充
widget->setPalette(pal);

注意：

• 样式表会覆盖调色板设置
• 需调用 setAutoFillBackground(true) 生效

---

方法 4：设置背景图片（扩展）

// C++ 示例
widget->setStyleSheet("background-image: url(:/images/bg.png);"
"background-repeat: no-repeat;"
"background-position: center;");

---

方法 5：OpenGL 场景特殊处理

// 在 QOpenGLWidget 中设置清屏颜色
void MyGLWidget::initializeGL() {
    glClearColor(1.0f, 0.0f, 0.0f, 1.0f); // 红色背景
}

---

全屏场景通用解决方案

// 组合方案（Qt/C++）
void setupFullScreen(QWidget* window) {
    // 1. 去除窗口边框
    window->setWindowFlags(Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint);


    // 2. 设置背景颜色（样式表方式）
    window->setStyleSheet("background-color: black;");


    // 3. 强制填充可用区域（排除任务栏）
    QRect available = QApplication::primaryScreen()->availableGeometry();
    window->resize(available.size());
    window->move(available.topLeft());


    // 4. 禁用 DPI 缩放干扰（可选）
    #if defined(Q_OS_LINUX)
    window->setAttribute(Qt::WA_NativeWindow, true);
    #endif
}

---

常见问题排查

1. 背景未显示：
   • 检查是否设置了 WA_NoSystemBackground 属性
   • 确认父控件的背景未覆盖子控件
2. 性能问题：
   • 避免在 paintEvent 中频繁创建 QPainter 对象
   • 使用 QPixmap 缓存静态背景
3. 多显示器适配：

   // 获取目标屏幕的可用区域
   QScreen* targetScreen = QGuiApplication::screens().at(1); // 第二个显示器
   QRect screenGeo = targetScreen->availableGeometry();

根据具体需求选择合适的方法，样式表适合快速开发，重写 paintEvent 适合复杂图形场景。全屏应用建议结合 availableGeometry 和样式表实现最佳显示效果。