继承QWidget的自定义控件添加子控件后样式表被忽略问题求助

问题原因 #

你遇到的是Qt自定义QWidget子类的默认特性：当自定义QWidget派生类包含子控件时，默认不会自动绘制样式表中定义的背景、边框等属性，只有没有子控件的空自定义QWidget才会默认生效样式表。

修复方案 #

你只需要给GlobalContainer类添加paintEvent的实现即可，步骤如下：

1. 在GlobalContainer.hpp的protected部分添加paintEvent声明：

protected:
    void paintEvent(QPaintEvent *event) override;

2. 在GlobalContainer.cpp中实现该函数，记得引入对应头文件：

#include <QPainter>
#include <QStyleOption>

void GlobalContainer::paintEvent(QPaintEvent *event)
{
    // 初始化样式选项，加载当前控件的样式配置
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    // 绘制QWidget基础样式，包含样式表定义的背景、边框等属性
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
    // 调用父类的paintEvent保证原有绘制逻辑正常运行
    QWidget::paintEvent(event);
}

补充说明 #

• 你后续测试中用的原生QWidget实例样式可以正常生效，正是因为原生QWidget默认已经实现了上述逻辑，只有自定义派生类需要手动添加。
• 该修改不会影响子控件的样式，全局应用的样式表、控件单独设置的样式表都可以正常生效。

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