用 VS Code 搞 Qt6：信号、槽，以及QObject

欢迎大家来到IT世界,在知识的湖畔探索吧!

用 VS Code 搞 Qt6：信号、槽，以及QObject

Qt 里面的信号（Signal）和槽（Slot）虽然看着像事件，但它实际上是用来在两个对象之间进行通信的。既然是通信，就会有发送者和接收者。

1、信号是发送者，触发时通过特有的关键字“emit”来发出信号。

2、槽是信号的接收者，它实则是一个方法（函数 ）成员，当收到信号后会被调用。

为了让C++类能够使用信号和槽机制，必须从 QObject 类派生。QObject 类是 Qt 对象的公共基类。它的第一个作用是让 Qt 对象之形成一株“对象树”。当某个 Qt 对象发生析构时，它的子级对象都会发生析构。比如，窗口中包含两个按钮，当窗口类析构时，里面的两个按钮也会跟着发生析构。所以，在 Qt 的窗口应用程序里面，一般不用手动去 delete 指针类型的对象。位于对象树上的各个对象会自动清理。

QObject 类的另一个关键作用是实现信号和槽的功能。

1、从 QObject 类派生的类，在类内部要使用 Q_OBJECT 宏。

2、跟在 signals 关键字后面的函数被视为信号。这个关键字实际上是 Q_SIGNALS 宏，是 Qt 项目专用的，并不是 C++ 的标准关键字。

3、跟在 slots 或 public slots 后面的成员函数（方法）被认为是槽，当接收到信号时会自动调用。

信号和槽之间相互不认识，需要找个“媒婆”让它们走到一起。因此，在发出信号前要调用 QObject :: connect 方法在信号与槽之间建立连接。

老舅不喜欢说得太复杂，上面的介绍应该算比较简洁了，接下来咱们来个示例，就好理解了。

【领QT开发教程学习资料，点击下方链接免费领取↓↓，先码住不迷路~】

点击→领取「链接」

这里老舅定义了两个类：DemoObject 类里面包含了一个 QStack

对象，是个栈集合，这个应该都懂，后进先出。两个公共方法，AddOne 用来向 Stack 对象压入元素，TakeOne 方法从 Stack 对象中弹出一个元素。不过，弹出的元素不是经 TakeOne 方法返回，而是发出 GetItem 信号，用这个信号将弹出的元素发送给接收者（槽在 TestRecver 类中）。第二个类是 TestRecver，对，上面 DemoObject 类发出的 GetItem 信号可以在 TestRecver 类中接收，槽函数是 setItem。

#include 
  
    #include 
   
     #include 
    
      class DemoObject : public QObject { // 这个是宏 Q_OBJECT private: QStack 
     
       _inner; public: void AddOne(int val) { _inner.push(val); } void TakeOne() { if(_inner.empty()){ return; } int x = _inner.pop(); // 发出信号 emit GetItem(x); } // 信号 signals: void GetItem(int n); }; class TestRecver : public QObject { // 记得用这个宏 Q_OBJECT // 槽 public slots: void setItem(int n) { std::cout << "取出项：" << n << std::endl; } }; 
      
     
    
  

欢迎大家来到IT世界,在知识的湖畔探索吧!

在 main 函数中，先创建 DemoObject 实例，用 AddOne 方法压入三个元素。然后创建 TestRecver 实例，用 connect 方法建立信号和槽的连接。

欢迎大家来到IT世界,在知识的湖畔探索吧!int main(int argc, char argv) { DemoObject a; a.AddOne(50); a.AddOne(74); a.AddOne(80); TestRecver r; // 信号与槽连接 QObject::connect(&a, &DemoObject::GetItem, &r, &TestRecver::setItem); // 下面这三行会发送GetItem信号 a.TakeOne(); a.TakeOne(); a.TakeOne(); return 0; }

下面是 CMakeLists.txt 文件：

cmake_minimum_required(VERSION 3.0.0) project(myapp LANGUAGES CXX) find_package(Qt6 REQUIRED COMPONENTS Core) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_AUTOMOC ON) add_executable(myapp main.cpp) target_link_libraries(myapp PRIVATE Qt6::Core)

注意，这里一定要把 CMAKE_AUTOMOC 选项设置为 ON，1，或者 YES。因为我们用到了 Q_OBJECT 宏，它需要 MOC 生成一些特定C++代码和元数据。这个示例只用到 QtCore 模块的类，所以 find_package 和 target_link_libraries 中只要引入这个就行。

当你兴奋异常地编译和运行本程序时，会发生错误：

欢迎大家来到IT世界,在知识的湖畔探索吧!

这个错误是因为 MOC 生成的代码最终要用回到我们的程序中的，但代码文件没有包含这些代码。所以你看上面已经提示你了，解决方法是包含 main.moc。这个文件名和你定义 DemoObject 类的代码文件名相同。我刚刚的代码文件是 main.cpp，所以它生成的代码文件就是 main.moc。

【领QT开发教程学习资料，点击下方链接免费领取↓↓，先码住不迷路~】

点击→领取「链接」

不过，#include 指令一定要写在 DemoObject 和 TestRecver 类的定义之后，这样才能正确放入生成的代码。# include 放在文件头部仍然会报错的，此时，DemoObject 和 TestRecver 类还没有定义，无法将 main.moc 中的源代码插入到 main.cpp 中（会找不到类）。

欢迎大家来到IT世界,在知识的湖畔探索吧!#include 
  
    #include 
   
     #include 
    
      class DemoObject : public QObject { // 这个是宏 Q_OBJECT …… }; class TestRecver : public QObject { // 记得用这个宏 Q_OBJECT …… }; #include "main.moc" int main(int argc, char argv) { …… return 0; } 
     
    
  

要是你觉得这样麻烦，最省事的做法是把类的定义写在头文件中，实现代码写在cpp文件中。MOC 默认会处理头文件，所以不会报错。

之后再编译运行，就不会报错了。

如果用的是 Windows 系统，cmd 默认编码是 GBK，不是 UTF-8，VS Code 的代码默认是 UTF8 的，控制台可能会打印出来乱码。这里老舅不建议改代码文件的编码，因为说不定你还要把这代码放到 Linux 系统中编译的。在 cmd 中用 CHCP 命令改一下控制台的编码，再运行程序就行了。

chcp 65001

其实，信号和槽的函数签名可以不一致。下面我们再来做一例。这个例子咱们用到 QWidget 类的 windowTitleChanged 信号。当窗口标题栏中的文本发生改变时会发出这个信号。它的签名如下：

欢迎大家来到IT世界,在知识的湖畔探索吧! void windowTitleChanged(const QString &title);

这个信号有一个 title 参数，表示修改的窗口标题文本（指新的标题）。而咱们这个例子中用于和它连接的槽函数是无参数的。

private slots: // 这个是槽 void onTitleChanged();

尽管签名不一致，但可以用。

在这个例子中，只要鼠标点一下窗口区域，就会修改窗口标题——显示鼠标指针在窗口中的坐标。窗口标题被修改，就会发出 windowTitleChanged 信号，然后，onTitleChanged 也会被调用。

接下来是实现步骤：

1、准备 CMakeLists.txt 文件。

欢迎大家来到IT世界,在知识的湖畔探索吧!cmake_minimum_required(VERSION 3.0.0) project(demo VERSION 0.1.0) find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_AUTOMOC ON) file(GLOB SRC_LIST ./*.h ./*.cpp) add_executable(demo WIN32 ${SRC_LIST}) target_link_libraries(demo PRIVATE Qt6::Core Qt6::Gui Qt6::Widgets)

这里老舅就偷懒一下。add_executable(demo ….) 是添加头文件和源码文件的。老舅嫌麻烦，加一个文件又要改一次，于是就用 file 命令搜索项目根目录下的所有头文件和 C++ 代码文件。然后把这些搜到的文件添加到变量 SRC_LIST 中。在 add_executable 命令中引用 SRC_LIST 变量，就可以自动添加文件了。

2、定义一个自定义窗口类，从 QWidget 类派生。

/* 头文件 */ #include 
  
    #include 
   
     #include 
    
      #include 
     
       #include 
      
        class MyWindow : public QWidget { Q_OBJECT public: MyWindow(QWidget* parent = nullptr); private slots: // 这个是槽 void onTitleChanged(); protected: void mousePressEvent(QMouseEvent *event) override; }; 
       
      
     
    
  

欢迎大家来到IT世界,在知识的湖畔探索吧!/* 实现代码 */ #include "MyWindow.h" // MyWindow::MyWindow(QWidget *parent) : QWidget::QWidget(parent) { // 窗口大小 resize(300, 275); connect(this, &MyWindow::windowTitleChanged, this, &MyWindow::onTitleChanged); } void MyWindow::onTitleChanged() { QMessageBox::information(this, "Test", "看，窗口标题变了。", QMessageBox::Ok); } void MyWindow::mousePressEvent(QMouseEvent *event) { auto pt = event->pos(); QString s = QString("鼠标指针位置：%1, %2") .arg(pt.x()) .arg(pt.y()); setWindowTitle(s); QWidget::mousePressEvent(event); } /*/

重写了 mousePressEvent 方法，当鼠标按钮按下时触发，先通过事件参数的 pos 函数得到鼠标坐标，再用 setWindowTitle 方法修改窗口标题。随即 windowTitleChanged 信号发出，在槽函数 onTitleChanged 中只是用 QMessgeBox 类弹出了一个提示框。运行结果如下图所示。

【领QT开发教程学习资料，点击下方链接免费领取↓↓，先码住不迷路~】

点击→领取「链接」

一个信号可以连接多个槽，一个槽可以与多个信号建立连接。这外交能力是真的强，来者不拒。下面咱们做一个 SaySomething 信号连接三个槽的实验。

#include 
  
    class SomeObj : public QObject { Q_OBJECT public: SomeObj(QObject *parent = nullptr); void SpeakOut(); // 用这个方法发信号 signals: void SaySomething(); }; class SlotsObj : public QObject { Q_OBJECT public slots: // 来几个cao void slot1(); void slot2(); void slot3(); }; 
  

以上是头文件。SomeObj 类负责发出信号，SlotsObj 类负责接收信号，它有三个 cao：slot1、slot2、slot3。

下面是 SomObj 类的实现代码。

欢迎大家来到IT世界,在知识的湖畔探索吧!SomeObj::SomeObj(QObject *parent) : QObject::QObject(parent) { // 无事干 } void SomeObj::SpeakOut() { emit SaySomething(); }

emit 关键字（Qt 特有）发出 SaySomething 信号。

下面是 SlotsObj 类的实现代码。

#include "app.h" #include 
  
    using namespace std; void SlotsObj::slot1() { cout << "第一个cao触发了" << endl; } void SlotsObj::slot2() { cout << "第二个cao触发了" << endl; } void SlotsObj::slot3() { cout << "第三个cao触发了" << endl; } 
  

来，咱们试一试，分别实例化 SomeObj 和 SlotsObj 类，然后让 SaySomething 信号依次与 slot1、slot2、slot3 建立连接。这是典型的“一号战三槽”。

欢迎大家来到IT世界,在知识的湖畔探索吧!int main(int argc, char argv) { // 分别实例化 SomeObj sender; SlotsObj recver; // 建立连接 QObject::connect(&sender, &SomeObj::SaySomething, &recver, &SlotsObj::slot1); QObject::connect(&sender, &SomeObj::SaySomething, &recver, &SlotsObj::slot2); QObject::connect(&sender, &SomeObj::SaySomething, &recver, &SlotsObj::slot3); // 发信号 sender.SpeakOut(); return 0; }

结果表明：信号一旦发出，三个 slot 都调用了。如下图：