用 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 方法在信号与槽之间建立连接。

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

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

#include <iostream>

#include <qobject.h>

#include <qstack.h>

class DemoObject : public QObject

{

    // 这个是宏

    Q_OBJECT

private:

    QStack<int> _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;

    }

};

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

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 中只要引入这个就行。

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

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

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

#include <iostream>

#include <qobject.h>

#include <qstack.h>

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 信号。当窗口标题栏中的文本发生改变时会发出这个信号。它的签名如下：

  void windowTitleChanged(const QString &title);

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

private slots:  // 这个是槽

    void onTitleChanged();

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

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

接下来是实现步骤：

1、准备 CMakeLists.txt 文件。

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 <QWidget>

#include <QMessageBox>

#include <QMouseEvent>

#include <QString>

#include <QApplication>

class MyWindow : public QWidget

{

    Q_OBJECT

public:

    MyWindow(QWidget* parent = nullptr);

private slots:  // 这个是槽

    void onTitleChanged();

protected:

    void mousePressEvent(QMouseEvent *event) override;

};

/*     实现代码      */

#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 类弹出了一个提示框。运行结果如下图所示。

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

#include <QObject>

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 类的实现代码。

SomeObj::SomeObj(QObject *parent)

    : QObject::QObject(parent)

{

    // 无事干

}

void SomeObj::SpeakOut()

{

    emit SaySomething();

}

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

下面是 SlotsObj 类的实现代码。

#include "app.h"

#include <iostream>

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 建立连接。这是典型的“一号战三槽”。

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 都调用了。如下图：

好了，今天的故事就讲到这儿了，欲知后事如何，且待下回分解。

巴特西

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

最新文章

热门文章