用 VS Code 搞 Qt6:信号、槽,以及QObject

2023-07-30,,

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的相关教程结束。

《用 VS Code 搞 Qt6:信号、槽,以及QObject.doc》

下载本文的Word格式文档,以方便收藏与打印。