QT子线程与主线程的信号槽通信

      最近用QT做一个服务器，众所周知，QT的主线程必须保持畅通，才能刷新UI。所以，网络通信端采用新开线程的方式。在涉及到使用子线程更新Ui上的控件时遇到了点儿麻烦。网上提供了很多同一线程不同类间采用信号槽通信的方式，但是并不完全适合线程间的信号槽通信，这主要体现在自定义消息的传递上。

首先我们看看一般的方式：

testthread.h 文件

#ifndef TESTTHREAD_H
#define TESTTHREAD_H

#include <QThread>

#include "msg.h"

class TestThread : public QThread
{
    Q_OBJECT
public:
    explicit TestThread(QObject *parent = 0);

protected:
    void run();

signals:
    void TestSignal(int);

private:
    Msg msg;
};

#endif // TESTTHREAD_H

testthread.cpp文件

#include "testthread.h"

TestThread::TestThread(QObject *parent) :
    QThread(parent)
{
}

void TestThread::run()
{
    //触发信号
    emit TestSignal(123);
}

自己定义的类继承了QThread类，重写run函数，然后触发TestSignal信号。

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

#include "testthread.h"

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

private slots:
    void DisplayMsg(int);

private:
    Ui::MainWindow *ui;
    TestThread *t;
};

#endif // MAINWINDOW_H

mainwindow.cpp

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

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    //进行connect前必须实例化
    t = new TestThread();   

    connect(t, SIGNAL(TestSignal(int)), this, SLOT(DisplayMsg(int)));

    //执行子线程
    t->start(); 
}

void MainWindow::DisplayMsg(int a)
{
    ui->textBrowser->append(QString::number(a));
}

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

Mainwindow里面连接信号槽，并且将收到的int参数显示在界面上。

运行效果

下面我们对程序进行一些简单，修改，使得它传输我们的自定义消息。

testthread.h 文件

#ifndef TESTTHREAD_H
#define TESTTHREAD_H

#include <QThread>

#include "msg.h"

class TestThread : public QThread
{
    Q_OBJECT
public:
    explicit TestThread(QObject *parent = 0);
    Msg msg;

protected:
    void run();

signals:
    void TestSignal(Msg);   //Msg!!!
};

#endif // TESTTHREAD_H

testthread.h 文件

#include "testthread.h"

TestThread::TestThread(QObject *parent) :
    QThread(parent)
{
}

void TestThread::run()
{
    msg.int_info = 999;
    msg.str_info = "Hello Main Thread!";
    //触发信号
    emit TestSignal(msg);
}

mainwindow.h 文件

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

#include "testthread.h"
#include "msg.h"

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

private slots:
    void DisplayMsg(Msg);   //Msg!!!

private:
    Ui::MainWindow *ui;
    TestThread *t;
};

#endif // MAINWINDOW_H

mainwindow.cpp 文件

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

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    //进行connect前必须实例化
    t = new TestThread();

    //Msg!!!
    connect(t, SIGNAL(TestSignal(Msg)), this, SLOT(DisplayMsg(Msg)));

    //执行子线程
    t->start();
}

void MainWindow::DisplayMsg(Msg msg)
{
    ui->textBrowser->append(QString::number(msg.int_info));
    ui->textBrowser->append(msg.str_info);
}

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

此时再进行编译，能够通过，但是Qt Creator会有提示

QObject::connect: Cannot queue arguments of type 'Msg'
(Make sure 'Msg' is registered using qRegisterMetaType().)

并且运行程序，不会有任何反应。

mainwindow.cpp文件 改动为

ui->setupUi(this);

qRegisterMetaType<Msg>("Msg");

此时能够正常运行

说明：

在线程间使用信号槽进行通信时，需要注意必须使用元数据类型

Qt内生的元数据类型，如int double QString 等

如果要用自己定义的数据类型，需要在connect前将其注册为元数据类型。形式见代码。