Qt 开发：深入详解 Qt 的信号与槽机制——彻底搞懂QT信号与槽

于 2024-09-14 09:32:38 发布
阅读量367 收藏 3
点赞数 10
分类专栏： QT开发从入门到精通 文章标签： qt 开发语言 c++
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/martian665/article/details/142181817
版权

一、概念

Qt 的信号与槽（Signals and Slots）机制是一个用于对象间通信的核心特性。这个机制使得对象能以松散耦合的方式进行通信，从而提升了代码的模块化和可维护性。

  • 信号（Signal）：对象状态的变化或事件发生时发出的通知。
  • 槽（Slot）：信号发出时调用的函数，用于处理信号。
  • 连接（Connect）：将信号和槽关联起来，使得信号发出时自动调用对应的槽。

二、原理机制

        信号与槽机制依赖于 Qt 的元对象系统（Meta-Object System），该系统通过 Q_OBJECT 宏和 MOC（Meta-Object Compiler）生成额外的代码来支持信号与槽功能。

三、工作流程

  1. 信号声明：在类中使用 signals 关键字声明信号。
  2. 槽声明和定义：在类中用 public slots、private slots 声明槽，并实现槽函数。
  3. 连接信号和槽：使用 QObject::connect() 函数将信号和槽连接起来。
  4. 发射信号：在适当时机调用信号，触发相应的槽函数。

四、实际项目示例

我们将通过一个简单的 Qt 应用程序来演示信号与槽机制。这个程序包含一个按钮和一个标签，当点击按钮时，标签显示的文字会改变。

步骤 1：创建 Qt 项目
  1. 打开 Qt Creator，选择 "File" -> "New File or Project"。
  2. 选择 "Application" -> "Qt Widgets Application"。
  3. 输入项目名称（例如 "SignalSlotExample"）。
  4. 选择项目路径并点击 "Next"。
  5. 选择适合的平台和 Qt 版本，点击 "Next"。
  6. 点击 "Finish" 创建项目。
步骤 2：设计用户界面
  1. 在项目树中，打开 mainwindow.ui 文件。
  2. 拖动一个 QPushButton 和一个 QLabel 到窗口中。
  3. 设置按钮和标签的文本为 "Click Me!" 和 "Hello, Qt!"。

步骤 3：添加按钮功能
1. 使用“转到槽”功能

“转到槽”功能允许你快速为UI控件添加槽函数，并自动生成必要的代码。

步骤

  1. 打开 UI 设计器：在项目树中，双击打开 mainwindow.ui 文件。
  2. 选择控件：在 UI 设计器中，选择想要添加槽函数的控件，比如 QPushButton。
  3. 右键菜单：右键点击选择的控件，并在弹出的右键菜单中选择“转到槽...”（Go to Slot...）。
  4. 选择信号：在弹出的对话框中，选择你希望处理的信号，例如 clicked()，然后点击“确定”或“添加”（Add）。

Qt Creator 将自动生成槽函数的声明和实现代码，并将你带到实现代码的位置。

执行上述步骤后，mainwindow.h 文件将自动添加新槽函数的声明，如下：

#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();

private slots:
    void on_pushButton_clicked();
    
private:
    Ui::MainWindow *ui;
};
#endif // MAINWINDOW_H

对应的槽函数实现也会自动添加到 mainwindow.cpp 文件中，修改 mainwindow.cpp

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

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

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

void MainWindow::on_pushButton_clicked()
{
    // 修改标签的文本
    ui->label->setText("Button Clicked!");
}
2. 自定义“添加信号”到槽功能

虽然“自定义添加信号”功能没有像“转到槽”那样的快捷选项，但你可以手动添加信号声明，并在代码中进行连接。

手动添加信号

  1. 修改 mainwindow.h 文件：在类中添加新的信号声明。 
    #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();

signals:
    void customSignal(); // 新的信号声明

private slots:
    void on_pushButton_clicked();

private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H

  2. 发射信号：在 mainwindow.cpp 文件中，发射自定义信号。我们可以在按钮点击槽函数中发射这个信号： 
    #include "mainwindow.h"
#include "ui_mainwindow.h"

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

    // 连接自定义信号到某个槽
    connect(this, &MainWindow::customSignal, this, &MainWindow::handleCustomSignal);
}

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

void MainWindow::on_pushButton_clicked()
{
    // 修改标签的文本
    ui->label->setText("Button Clicked!");
    // 发射自定义信号
    emit customSignal();
}

void MainWindow::handleCustomSignal()
{
    // 处理自定义信号
    ui->label->setText("Custom Signal Emitted!");
}

    自定义添加信号到槽关键步骤：

    自定义槽 handleCustomSignal，并在 mainwindow.cpp 中实现：

    1、声明信号：

       在 mainwindow.h 中声明新的信号

    signals:
    void customSignal(); // 新的信号声明

    2、声明槽：

     在 mainwindow.h 中声明新的槽

    private slots:
    void on_pushButton_clicked();
    void handleCustomSignal(); // 新的槽声明

    3、处理自定义信号（槽的实现）

    void MainWindow::handleCustomSignal()
{
    // 处理自定义信号
    ui->label->setText("Custom Signal Emitted!");
}

    4、连接自定义信号到指定槽：

    // 连接自定义信号到指定槽
    connect(this, &MainWindow::customSignal, this, &MainWindow::handleCustomSignal);

    5、发射信号

     // 发射自定义信号
    emit customSignal();
步骤 4：运行程序
  1. 点击 Qt Creator 工具栏上的 "Run" 按钮。
  2. 在弹出的窗口中，点击按钮，观察标签的文本变化。

详细解释

  • 信号声明：在 Qt 中，信号是通过在类中使用 signals 关键字声明的。在这个例子中，QPushButton 已经有了一个名为 clicked() 的信号。
  • 槽声明和定义：槽是一个普通的成员函数，可以在类中用 public slots、private slots 声明。在这个例子中，我们在 MainWindow 类中声明并定义了一个槽 handleButtonClick()。
  • 连接信号和槽：使用 QObject::connect() 函数将信号和槽连接起来。参数包括发出信号的对象、信号名称、接收信号的对象和槽名称。
  • 发射信号：当按钮被点击时，QPushButton 内部自动发射 clicked() 信号，触发 handleButtonClick() 槽。

五、常见问题和调试

  • 未使用 Q_OBJECT 宏：信号与槽机制依赖于 Qt 的元对象系统，必须在类中加入 Q_OBJECT 宏。
  • 信号未正确连接：确保 connect() 函数的参数类型匹配。
  • 对象未正确管理：确保信号发出者和槽接收者对象的生命周期被正确管理，避免提前销毁。

        通过以上详细步骤和解释，我们实现了一个简单的 Qt 应用程序，并深入理解了信号与槽机制的工作原理和应用方式。希望这能帮助你更好地掌握 Qt 开发。

六、带参数的信号和槽

        上面的实列中信号和槽是没有带参数传递的，那么信号和槽可以带参数传递吗？那是肯定的，在 Qt 的信号与槽机制中，信号和槽可以带参数。这种功能非常强大，可以让你在发射信号时传递数据到槽函数中进行处理。接下来，我们将演示如何为信号和槽添加参数。

修改示例带参数

        假设我们要修改前面的示例，使得自定义信号 customSignal 可以传递一个字符串参数，并在槽函数中处理这个参数。

修改 mainwindow.h

首先，我们需要修改信号和槽的声明，使其带有参数：

#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();

signals:
    void customSignal(const QString &message); // 带参数的信号声明

private slots:
    void on_pushButton_clicked();
    void handleCustomSignal(const QString &message); // 带参数的槽声明

private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H

在这里信号和槽的声明都已经带了参数，如下

signals:
    void customSignal(const QString &message); // 带参数的信号声明

private slots:
    void handleCustomSignal(const QString &message); // 带参数的槽声明

修改 mainwindow.cpp

接下来，我们需要在合适的位置发射信号，并在槽函数中处理传递的参数。

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

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

    // 连接自定义信号到槽，注意这里的参数类型需要匹配
    connect(this, &MainWindow::customSignal, this, &MainWindow::handleCustomSignal);
}

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

void MainWindow::on_pushButton_clicked()
{
    // 修改标签的文本
    ui->label->setText("Button Clicked!");
    // 发射自定义信号，传递参数
    emit customSignal("Custom Signal Emitted with Parameter!");
}

void MainWindow::handleCustomSignal(const QString &message)
{
    // 处理自定义信号，接收参数
    ui->label->setText(message);
}

运行程序
  1. 点击 Qt Creator 工具栏上的 "Run" 按钮。
  2. 在弹出的窗口中，点击按钮，观察标签的文本变化。

详细解释

  • 信号声明：在类中使用 signals 关键字声明带参数的信号。例：void customSignal(const QString &message);
  • 槽声明和定义：在类中用 private slots 或 public slots 声明带参数的槽，并实现槽函数。例：void handleCustomSignal(const QString &message);
  • 连接信号和槽：使用 QObject::connect() 函数将带参数的信号和槽连接起来。注意信号和槽的参数类型必须匹配。
  • 发射信号：在适当时机调用信号，并传递参数。例：emit customSignal("Custom Signal Emitted with Parameter!");
  • 处理参数：在槽函数中接收并处理传递的参数。

        通过以上步骤和详细解释，我们实现了一个带参数的信号与槽示例，并深入理解了 Qt 信号与槽机制中带参数的用法。

七、信号（signals）的 访问权限

              上面的例子中，我们看到信号的声明

signals:
    void customSignal(const QString &message); // 带参数的信号声明

并没有带public、protected 或 private关键字，那么它到底是什么权限呢？下面我们进行讲解。

        在 Qt 中，信号（signals）在类中是默认的 protected 访问权限，而不是 private。这意味着信号通常只能从类内部或其派生类中发射（emit）。然而，在实际使用中，你可以将信号声明为 public、protected 或 private，以控制其访问权限。

默认情况

如果你不显式声明信号的访问权限，信号默认是 protected：

signals:
    void customSignal(const QString &message); // 带参数的信号，默认是protected
显式声明访问权限

你可以显式地声明信号为 public、protected 或 private：

如 public 信号：


### 示例

如果我们希望信号能够从类的外部发射，可以将信号声明为 `public`：

#### 修改 `mainwindow.h`

```cpp
#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 signals: // 显式声明信号为public
  void customSignal(const QString &message); // 带参数的信号声明

private slots:
  void on_pushButton_clicked();
  void handleCustomSignal(const QString &message); // 带参数的槽声明

private:
  Ui::MainWindow *ui;
};

#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(this, &MainWindow::customSignal, this, &MainWindow::handleCustomSignal);
}

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

void MainWindow::on_pushButton_clicked()
{
    // 修改标签的文本
    ui->label->setText("Button Clicked!");
    // 发射自定义信号，传递参数
    emit customSignal("Custom Signal Emitted with Parameter!");
}

void MainWindow::handleCustomSignal(const QString &message)
{
    // 处理自定义信号，接收参数
    ui->label->setText(message);
}
  • 关键说明
  • 默认情况下，signals 关键字下声明的信号是 protected。
  • 你可以根据需要显式地将信号声明为 public、protected 或 private。
  • 选择合适的访问权限取决于你希望信号从哪里发射和使用。

八、信号和槽的优点

  • 松耦合：信号和槽使对象之间的通信更加松散，无需对象彼此了解。
  • 类型安全：编译时检查信号和槽的签名是否匹配，避免了运行时错误。
  • 灵活性：可以动态连接和断开信号和槽，支持多种连接模式（例如，一个信号连接多个槽，或多个信号连接一个槽）。

总结

Qt 的信号和槽机制为开发者提供了一种优雅、灵活且类型安全的方式来处理对象间的通信。通过理解和利用这一机制，可以显著提高应用程序的模块化、可维护性和可扩展性。

猿享天开
关注
专栏目录
QT QML信号与信号槽详解
06-20
QT QML信号与信号槽是Qt框架中一种强大的通信机制，尤其在跨界面与后台代码交互时发挥着关键作用。本文将深入解析这种机制，并探讨其在移动开发和其他相关领域的应用。 首先，QML（Qt Meta Language）是Qt提供的一...
PyQt5通信机制 信号与槽详解
09-18
在PyQt5编程中，信号与槽是核心的通信机制，用于对象间的交互。它们提供了一种优雅的方式来处理事件和响应用户操作。本文将深入探讨PyQt5中的信号与槽，以及如何使用它们来实现应用的功能。 信号是PyQt5中特定对象...
QT信号和槽机制
10-13
### QT信号和槽机制详解 #### 一、引言 信号和槽机制是Qt框架中的核心功能之一，它提供了一种高效且灵活的方式来处理不同组件间的通信问题。相较于传统的回调函数方式，信号和槽机制更加优雅，同时也更易于维护。...
QT学习之信号与槽之个人理解
05-08
### QT学习之信号与槽机制详解 #### 一、引言 在QT框架中，信号与槽机制是一种非常重要的通信机制，它使得不同组件之间能够有效地进行数据传递和交互。本文将详细介绍信号与槽的基本概念、工作原理以及如何在实际...
QT实现信号与槽机制
12-10
**QT实现信号与槽机制详解** Qt库是一个强大的跨平台应用程序开发框架，广泛应用于图形用户界面（GUI）和非GUI程序。在Qt中，信号与槽机制是其核心特性之一，用于实现对象间的通信。这一机制允许不同对象之间在特定...
QT开发基础与环境搭建+C++与QT结合进阶+QT信号与槽机制详解+QT界面设计与布局管理+QT数据库操作等全套教程
08-10
QT信号与槽机制详解 QT界面设计与布局管理 QT数据库操作与SQLite集成 QT网络编程技术 QT多线程与并发控制 QT国际化与本地化支持 QT图形与图像处理 QT多媒体开发 QT游戏开发入门 QT跨平台开发实践 QT性能优化与调试...
Qt信号和槽
09-29
### Qt信号和槽详解 #### 一、引言 在Qt框架中，信号与槽机制是一种用于对象间通信的关键机制，它使得不同组件之间能够轻松地进行数据交换和事件响应。这种机制的设计非常灵活，一个信号可以连接多个槽，反之亦然...
详解PyQt5信号与槽的几种高级玩法
09-17
槽函数可以有与信号匹配的参数，例如： ```python class MyWidget(QWidget): ... def setValue_NoParameters(self): pass def setValue_OneParameter(self, nIndex): pass def setValue_OneParameter_...
QT信号与槽.pdf
03-06
### QT信号与槽详解 #### 一、概述 信号与槽是QT框架中的一项核心机制，对于...通过深入理解信号与槽的基本概念、元对象工具以及如何在实际项目中有效利用这些特性，开发者可以更加高效地开发出高质量的QT应用程序。
QtQuick组件与对象动态创建详解（一）
03-03
Component是由Qt框架或开发者封装好的、只暴露了必要接口的QML类型，可以重复利用。一个QML组件就像一个黑盒子，它通过属性、信号、函数和外部世界...《QtQuick事件处理之信号与槽》一文中使用到Component的示例QML代
浅谈pyqt5中信号与槽的认识
09-19
### PyQt5中信号与槽机制详解 #### 一、引言 PyQt5是一个用于创建图形用户界面（GUI）的应用程序框架，它基于Qt库并兼容Python语言。PyQt5的强大之处在于它提供了丰富的功能来构建高效且美观的桌面应用程序。在PyQt...
QtQuick组件与对象动态创建详解（二）
03-03
现在我们看看如何动态创建、销毁组件。下面是dynamic_component.qml：这次我们在界面上放一个按钮，通过按钮...图5是颜色选择组件显示后的效果图：图5颜色组件创建后的效果使用Loader控制组件的动态创建与销毁，只是Qt
QT：用QWebSocket实现webchannel，实现C++与HTML通信
07-19
基本原理是通过channel将C++对象暴露给HTML，在HTML中调用qwebchannel.js。前提是建立transport，QT只提供了一个抽象基类QWebChannelAbstractTransport。
自编qt入门小例程（新建窗口及信号槽）
08-28
**Qt入门小例程——构建窗口与信号槽详解** 在编程世界中，Qt是一个非常流行的跨平台应用程序开发框架，尤其适用于GUI（图形用户界面）应用。这个“自编qt入门小例程”旨在帮助初学者理解和掌握Qt的基本操作，包括...
QT开发的概要介绍与分析
05-04
### QT开发概要介绍与分析 #### 一、QT开发框架概述 QT开发是一套广泛应用于跨平台C++图形用户界面应用程序开发的强大框架。它以其丰富的API和工具集著称，能够帮助开发者高效地构建既功能强大又界面美观的应用...
Qt窗口通信UI小项目
03-09
**Qt窗口通信UI小项目详解** ...通过学习和实践，开发者不仅能掌握Qt的基本用法，还能深入理解对象间的通信机制，以及如何将硬件通信与用户交互结合在一起，这对于开发各种类型的应用都有着重要的参考价值。
Ubuntu14.04安装、配置与卸载QT5的步骤详解
09-14
QT5是Qt开发框架的一个版本，它为开发者提供了丰富的库和工具，用于构建跨平台的图形用户界面应用程序。本文将详细介绍在Ubuntu 14.04操作系统上安装、配置和卸载QT5的详细步骤。 **一、安装QT5** 1. 首先，从官方...
Qt常用控件——QPushButton
Dirty_artist的博客
09-08 1159
QPushButton介绍
QT::QComboBox自定义左击事件信号
最新发布
牛牛的博客
09-13 150
添加一个原来的控件QComboBox，然后把这个控件提升为MyComboBox就可以使用了
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

猿享天开

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值