当前位置：首页 > article >正文

Qt_自定义信号

article 2025/1/22 14:51:11

1、自定义信号的规定

2、创建自定义信号

3、带参数的信号与槽

4、一个信号连接多个槽

5、信号与槽的断开

结语

前言：

虽然Qt已经内置了大量的信号，并且这些信号能够满足大部分的开发场景，但是Qt仍然允许开发者自定义信号，给开发者提供了足够的DIY设计空间。

1、自定义信号的规定

Qt中的信号实际上就是函数，因此自定义信号本质就是自定义函数，只不过自定义信号函数的写法要遵循以下三点：

1、Qt提供了关键字“signals”，自定义信号函数必须写在 “signals” 关键字下边。

2、自定义信号函数只需要声明，不需要实现，返回值要为void。

3、自定义信号函数可以有形参，允许重载。

当然，有了自定义信号函数后还需要拥有将该信号发出的能力，可以使用emit关键字修饰信号函数，表示发送该信号。"emit" 是⼀个空的宏。

2、创建自定义信号

有了上述的规则后，可以手动创建一个自定义信号，并给该信号连接一个槽函数，槽函数内打印一条语句，运行代码后若输出窗口中打印出了语句说明自定义信号成功创建，具体代码如下。

1、widget.h的代码如下：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

signals:
    void mySignal();//自定义信号

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
    void Print();//槽函数声明

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H

2、widget.cpp的代码如下：

#include "widget.h"
#include "ui_widget.h"

#include <QDebug>
#include <QPushButton>

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

    connect(this,&Widget::mySignal,this,&Widget::Print);//连接信号与槽

    emit mySignal();//发送信号
}

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

void Widget::Print()
{
    qDebug()<<"自定义信号调用的自定义槽函数";
}

运行结果：

从结果可以看到，槽函数里的语句被打印，说明自定义信号成功被触发且执行了对应的槽函数。

3、带参数的信号与槽

Qt中的信号与槽在代码的层面上都是函数，既然是函数所以他们都可以有形参，不过严格规定信号的参数要与连接的槽的参数类型保持一致，信号的参数多于槽参数都是可以的。当发送该信号时，调用信号所传的实参会传给信号函数的形参，然年信号函数再传递给槽函数，示意图如下：

代码实现如下，1、widget.h的代码如下：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

signals:
    void mySignal(QString s);//自定义信号

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
    void Print(QString s);//槽函数声明

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H

2、widget.cpp的代码如下：

#include "widget.h"
#include "ui_widget.h"

#include <QDebug>
#include <QPushButton>

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

    connect(this,&Widget::mySignal,this,&Widget::Print);//连接信号与槽

    emit mySignal("这是一个带有参数的信号");//发送信号
}

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

void Widget::Print(QString s)
{
    qDebug()<<s;
}

测试结果：

4、一个信号连接多个槽

上述的例子中是一个信号连接一个槽函数，因此当发送该信号时会调用一次槽函数。那么当一个信号连接多个槽函数时，发送该信号时具体的调用方式是什么呢？代码测试如下。

1、widget.h的代码如下：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

signals:
    void mySignal(QString s);//自定义信号

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
    void Print(QString s);//槽函数声明1
    void Print2(QString s);//槽函数声明2

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H

2、widget.cpp的代码如下：

#include "widget.h"
#include "ui_widget.h"

#include <QDebug>
#include <QPushButton>

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

    connect(this,&Widget::mySignal,this,&Widget::Print);//连接信号与槽
    connect(this,&Widget::mySignal,this,&Widget::Print2);//连接信号与槽

    emit mySignal("这是一个带有参数的信号");//发送信号
}

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

void Widget::Print(QString s)
{
    qDebug()<<s+"槽函数1";
}

void Widget::Print2(QString s)
{
    qDebug()<<s+"槽函数2";
}

测试结果：

结果是当一个信号连接多个槽时，发送该信号会调用所有连接的槽的函数，侧面也反映出不仅仅是一个信号可以连接多个槽，一个槽也可以被多个信号连接，只不过这种方式的逻辑就和单个信号连接单个槽的逻辑一样，这里就不再展示代码了。

5、信号与槽的断开

使⽤disconnect函数即可完成断开，disconnect的⽤法和connect相似，disconnect的形参和connect是一样的，即连接的逻辑和断开的逻辑是一样的。比如在上述代码中，一个信号连接了两个槽函数，使用disconnect函数断开与其中一个槽函数的连接，那么发送信号时只会执行一个槽函数，测试结果如下：