Qt：设置Qwidget类背景方法总结

面条有点辣

已于 2023-09-05 15:39:15 修改

阅读量8.5k

点赞数 7

CC 4.0 BY-SA版权

分类专栏： Qt 文章标签： qt ui 开发语言

于 2023-03-09 21:32:30 首次发布

本文链接：https://blog.csdn.net/qq_42301196/article/details/129431429

Qt 专栏收录该内容

7 篇文章

订阅专栏

本文介绍了在Qt中给Qwidget设置背景图片的四种方法：1)使用样式表setStyleSheet；2)通过QPalette设置调色板；3)重写paintEvent事件；4)利用QLabel或QFrame配合resizeEvent。每种方法的特点和适用场景都有所不同，例如setStyleSheet简单高效，QLabel支持动态图，paintEvent适用于自定义绘制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、引言

在实现一个页面跳转功能时，选择PushButton或QWidget可以有效当作按钮，而Qwidget可以添加label或者其它控件，自定义程度更高，因此本文给出几种给Qwidget绘制背景图片方法。

2、使用样式表（setStyleSheet）

    ui->widget->setStyleSheet("border-image:url(://MainButton1.png)");

该种方法简单高效，可以快速实现Qwidget背景图片的切换。

3、QPalette

QPalette pal =this->palette();
pal.setBrush(QPalette::Background,QBrush(QPixmap(":/bg.jpg")));
setPalette(pal);

首先获得Widget调色板，再设置Brush，最后将设置应用到Widget中。
若显示不出来加上setAutoFillBackground(true);

    // 设置背景图片
    setAutoFillBackground(true);    // 这句要加上, 否则可能显示不出背景图.
    QPalette palette = this->palette();
    //palette.setColor(QPalette::Window, Qt::red);  // 设置背景色
    //palette.setBrush(this->backgroundRole(), Qt::black);// 设置背景色
    palette.setBrush(QPalette::Window,
            QBrush(QPixmap(":/image/bkg.png").scaled(    // 缩放背景图.
                this->size(),
                Qt::IgnoreAspectRatio,
                Qt::SmoothTransformation)));    // 使用平滑的缩放方式
    this->setPalette(palette);

4、paintEvent事件

void Widget::paintEvent(QPaintEvent * ev)
{
	QPainter painter(this);
	painter.drawPixmap(rect(),QPixmap(":/bg.jpg"),QRect());
}

使用drawPixmap方法绘制一个矩形，传入第三个参数QRect()表示整个矩形区域，使用需要在新的类中重写PaintEvent，不适用于子窗口中的Widget绘制。

5、简洁方式

QLabel：

Widget::Widget(QWidget *parent) :
	QWidget(parent)
{
	m_lblBg = new QLabel(this);
	m_lblBg ->setPixmap(QPixmap(":/bg.jpg"));
	m_lblBg ->setScaledContents(true);
}
void Widget::resizeEvent(QResizeEvent * ev)
{
	m_lblBg->resize(this->size());
}

需要调用QLabel的setScaledContents(true)，否则会和使用qss效果相同，不过label可以显示动态图，因此这种方式也适用于动态界面。

QFrame：

    QFrame *frame = new QFrame(this);
    frame->setObjectName("myframe");
    frame->setGeometry(this->geometry());
    frame->resize(width(),height());
    frame->setStyleSheet("QFrame#myframe{border-image:url(:/image/bkg.png)}" );