Qt中在子线程中刷新UI的方法

发布于:2025-05-11 ⋅ 阅读:(15) ⋅ 点赞:(0)

Qt中在子线程中刷新UI的方法

在Qt中UI界面并不是线程安全的,意味着在子线程中不能随意操作UI界面组件(比如按钮、标签)等,如果强行操作这些组件有可能会导致程序崩溃。那么在Qt中如何在子线程中刷新UI控件呢?

两种方法:

方法一:使用信号槽机制。

第一步:创建一个QWidget项目,并且在其中添加一个继承自QThread的子线程类QWorkThread,如下:

#ifndef QWORKTHREAD_H
#define QWORKTHREAD_H

#include <QObject>
#include<QThread>


class QWorkThread : public QThread
{
    Q_OBJECT
public:
    explicit QWorkThread(QThread *parent = nullptr);
    QWorkThread(QWidget* pWidget,QThread *parent = nullptr);
    QWidget* m_pWidget = nullptr;

protected:
    virtual void run() override;

signals:
    void UpdateUI(QString strInfo);
};

#endif // QWORKTHREAD_H

说明:

1.自定义一个信号UpdateUI用来刷新主线程UI。

2.重写run函数,使用emit 发射UpdateUI信号如下:

void QWorkThread::run()
{
    emit UpdateUI("刷新控件");
}

第二步:在MainWindow中定义一个槽函数,用来响应UpdateUI信号:

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

public slots:
    void UpdateWidgetUI(QString strInfo);


private:
    Ui::MainWindow *ui;
};
#endif // MAINWINDOW_H

第三步:调用connect连接UpdateUI信号和UpdateWidgetUI槽函数,刷新UI:

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include "qworkthread.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    QWorkThread* pThread = new QWorkThread(ui->label);
    connect(pThread,&QWorkThread::UpdateUI,this,&MainWindow::UpdateWidgetUI);
    connect(pThread,&QThread::finished, pThread, &QThread::deleteLater);
    pThread->start();
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::UpdateWidgetUI(QString strInfo)
{
    ui->label->setText(strInfo);
}

程序运行前后结果:

微信截图_20250510231328

微信截图_20250510231328

方法二:使用invokeMethod()方法。

第一步:增加一个带QWidget的构造函数,并且在QWorkThread定义一个QWidget 类型的变量用来保存要刷新的控件。如上QWorkThread头文件中。

第二步:修改QWorkThread::run方法如下:

void QWorkThread::run()
{
    if(m_pWidget != nullptr)
      QMetaObject::invokeMethod(m_pWidget,"setText",Qt::QueuedConnection,Q_ARG(QString,"刷新控件2"));
}

其中调用QMetaObject::invokeMethod方法。

程序运行结果如下:

微信截图_20250510232257

虽然Qt不允许子线程直接操作UI界面,但通过信号与槽机制或invokeMethod()方法,子线程和UI线程可以安全地进行交互。这些机制确保了多线程程序的稳定性,避免了UI更新时可能出现的线程安全问题。

参考文章:Qt/C++面试【速通笔记五】—子线程与GUI线程安全交互


网站公告

今日签到

点亮在社区的每一天
去签到