用 VS Code 搞 Qt6:让信号和槽自动建立连接
Qt 具备让某个对象的信号与符合要求的槽函数自动建立连接。弄起来也很简单,只要调用这个静态方法即可:
QMetaObject::connectSlotsByName(...);
connectSlotsByName 方法需要一个参数,此参数的指针指向一个实例,这个实例自身的信号,以及它的子级对象的信号都会自动连接。
不过,在用的时候要注意以下几点,否则 connectSlotsByName 方法是不起作用的。
1、如果类是从某个 QObject 类派生的,比如常见的 QWidget 类,在类的声明中一个定要加上 Q_OBJECT 宏。这条老周在上一篇中说过,不加这个信号和槽不能建立连接。
2、对象一定要有 Name,即用 setObjectName 方法设置。虽然对象可以使用重复的名字,但不建议这样做,因为 connectSlotsByName 方法只要找到一个名字匹配的对象,就会停止查找。所以,就算你设置了 10 个名为“myButton” 的对象,结果也只能有一个会自动绑定信号和槽,其他的同名对象会忽略。
3、一定要在所有对象都初始化完毕,包括调用 setObjectName 方法设置对象名称后调用 connectSlotsByName 方法。这样才会有效。
setObjectName 方法用起来很简单,只要传递对象的名字即可,字符串类型。名字你可以随便取。例如
QLabel lb ... lb.setObjectName("bug");
这时候,标签对象的名字是“bug”。
Slot 要支持被自动连接,函数(方法)也是有严格的命名规则的。你必须按照这个规则来,否则不会被识别。槽函数命名规则如下:
on_XXX_SSS
1、以“on”开头,每一节用下划线连起来。
2、XXX 是对象名,注意是对象名,就是用 setObjectName 方法设置的名称,不是你代码中定义的变量名。这个得注意,不能搞错了。
3、SSS 是信号。
比如,按钮的 clicked 信号,你让要自己写的槽能够被自动连接,就得这样命名槽函数:on_mybtn_clicked。其中,“mybtn”是对象名。
------------------------------------------- 银河分隔线 ------------------------------------------
下面咱们来动手做个例子,就好理解了。
一、先弄好 CMake 文件。
cmake_minimum_required(VERSION 3.0.0) project(TestApp VERSION 0.1.0) find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED YES) set(CMAKE_AUTOMOC YES) add_executable(TestApp WIN32 main.cpp app.h app.cpp) target_link_libraries(TestApp PRIVATE Qt6::Core Qt6::Gui Qt6::Widgets)
这个示例有三个文件。main.cpp 是写 main 函数的地方。app.h 和 app.cpp 中是咱们自定义的窗口类——从 QWidget 类派生。
二、定义 MyWindow 类,基类是 QWidget。
/** app.h **/ #include <QMetaObject> #include <QWidget> #include <QApplication> #include <QObject> #include <QLabel> #include <QPushButton> #include <QMessageBox> #include <QVBoxLayout> #include <QHBoxLayout> class MyWindow : public QWidget { // 这个宏很容易忘了,忘了就不能连接信号和槽了 Q_OBJECT public: // 构造函数 MyWindow(QWidget* parent = nullptr); // 析构函数 ~MyWindow(); private: // 私有函数 void initUi(void); // 以下是用到的部件(控件) QPushButton *btn1; QPushButton *btn2; QLabel *lb; // 布局 QVBoxLayout *layout; QHBoxLayout *sublayout; // 这几个函数是用于自动绑定的槽 private slots: void on_b1_clicked(); void on_b2_clicked(); };
所有 QObject 的子类,想使用 Signal 和 Slot ,必须调用 Q_OBJECT 宏。这里有两个按钮,on_b1_clicked 和 on_b2_clicked 都是槽。要让两个按钮自动连接,必须分别设置它的 object name 为 “b1” 和 “b2”。
三、下面是 initUi 函数的实现代码,用于初始化窗体。
void MyWindow::initUi() { // 按钮1 btn1 = new QPushButton(this); // 设置按钮1的文本 btn1 -> setText("左边"); // 重要:给它个名字 btn1 -> setObjectName("b1"); // 按钮2 btn2 = new QPushButton(this); // 设置按钮2的文本 btn2 -> setText("右边"); // 重要:设置名称 btn2 -> setObjectName("b2"); // 标签 lb = new QLabel("请点击下面的按钮", this); // 布局 layout = new QVBoxLayout(this); layout -> addWidget(lb, 0, Qt::AlignTop); sublayout = new QHBoxLayout(this); // 添加要布局的组件 sublayout -> addWidget(btn1); sublayout -> addWidget(btn2); layout->addLayout(sublayout); // 窗口 this -> setWindowTitle("示例王"); this -> resize(240, 100); }
调用按钮对象的 setObjectName 方法就可以为其分配名称。注意在调用 QPushButton 类的构造函数时,要把当前窗口的指针传递给 parent 参数,使用按钮成为 MyWindow 的子级对象。这样后面才能做信号与槽的自动连接。
四、在 MyWindow 类构造函数中,先调用 initUi ,再调用 connectSlotsByName 静态方法。
MyWindow::MyWindow(QWidget *parent) : QWidget::QWidget(parent) { // 调用以下函数,初始化UI initUi(); // 一定要在所有东东都初始化完毕后调用才有效 QMetaObject::connectSlotsByName(this); }
五、下面是两个槽函数的实现。功能简单,用 QMessageBox 显示弹出框。
void MyWindow::on_b1_clicked() { QMessageBox::information(this, "好消息", "左转是男厕", QMessageBox::Ok); } void MyWindow::on_b2_clicked() { QMessageBox::information(this, "好消息", "右转是女厕", QMessageBox::Ok); }
六、在 main.cpp 中写 main 函数。
#include "app.h" int main(int argc, char *argv[]) { QApplication app(argc, argv); // 实例化窗口 MyWindow wind; // 显示窗口 wind.show(); // 消息循环 return app.exec(); }
运行结果如下面超清动画所示。
从结果可以看到,名为“b1”的按钮自动将 clicked 信号连接到 on_b1_clicked 函数;名为“b2”的按钮自动将 clicked 信号连接到 on_b2_clicked 函数。
好了,今天的主题咱们就聊到这儿了。