如何在Qt Designer中为QStackedWidget的提升页面设置样式表

核心原因 #

你遇到的样式失效问题主要由3个Qt样式表的特性导致：

• 你将page提升为SplashWidget自定义类后，QWidget#page选择器仅匹配基类为QWidget、objectName为page的控件，不会自动匹配QWidget的子类对象
• 自定义QWidget子类如果没有重写paintEvent方法，默认不支持Qt样式表渲染
• 子控件自身携带的样式表优先级高于父窗口（MainWindow）的样式表，会直接覆盖父级规则

可行解决方案 #

1. 修改选择器适配自定义类
   将你在MainWindow中的样式选择器修改为以下两种中的任意一种即可：

/* 方式1：指定自定义类名匹配 */
SplashWidget#page
{ 
    background-image: url(:/resources/img/NMS_Background.png);
}   

/* 方式2：通配ID选择器，只要objectName为page就匹配，不受类名限制 */
*#page
{ 
    background-image: url(:/resources/img/NMS_Background.png);
}   

2. 自定义控件补充paintEvent实现
   如果你的SplashWidget类还没有重写paintEvent，需要在cpp实现中添加以下代码，否则所有对该控件的样式表规则都不会生效：

#include <QStyleOption>
#include <QPainter>

void SplashWidget::paintEvent(QPaintEvent *event)
{
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
    QWidget::paintEvent(event);
}

3. 处理样式优先级冲突
   如果SplashWidget自带的样式表覆盖了MainWindow的规则，可以在你的样式属性后加!important提升优先级：

*#page
{ 
    background-image: url(:/resources/img/NMS_Background.png) !important;
}   

也可以直接把背景样式规则写到SplashWidget自身的样式表中，优先级更高。

4. 辅助校验
   优先确认page控件的objectName确实为page没有拼写错误，同时可以将资源路径替换为本地图片的绝对路径测试，排除资源文件加载失败的问题。

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