Qt之信号与槽 connect新语法（自动关联）

原创已于 2022-11-04 18:04:28 修改 · 987 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#qt #开发语言 #c++

于 2022-11-04 18:03:11 首次发布

QT 专栏收录该内容

46 篇文章

订阅专栏

本文介绍了Qt5中信号与槽机制的新语法及其优势。详细对比了Qt5前后版本信号与槽连接方式的区别，包括编译期检查、类型转换及连接任意函数等内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在 Qt 5 之前，我们需要使用下面的语句来链接 signal 和 slot：

connect(sender, SIGNAL(valueChanged(QString, QString)),
receiver, SLOT(updateValue(QString)));
Qt 实际上利用SIGNAL和SLOT这两个宏，把其后的函数名转换成一个字符串。随后，moc 将会扫描全部文件，将所有的 signal 和 slot 提取出来做成一个映射表。QObject::connect()函数则会从这个映射表里面找到该字符串，从 signal 的名字就可以找到 slot 的名字，因此也就知道了在 signal emit 的时候，该去调用哪一个 slot 函数。

从上面的解释可以看出，Qt 5 之前版本提供的这种语法其实有一些问题：

没有编译期检查：因为函数名被处理成字符串，所有的检查都是在运行时完成的。这就是为什么有时会发生编译通过了，但 slot 并没有被调用。此时，你就应该去检查 console 的输出，看看有没有什么 warning 说明 connect 并没有成功。
因为处理的是字符串，所以 slot 中的类型名字必须用 signal 的完全一致，而且在头文件中的和实际 connect 语句中的也必须一致。也就是说，如果你使用了 typedef 或者 namespace，connect 就可能不成功（在 Qt 5 之前的版本中，我们当然也可以使用 namespace，但是必须保证头文件中的和 connect 语句中的文本完全一致）。
在 Qt5 提供了一套新的语法。之前的语法依然可以使用，但是现在，我们有了更好的选择：

class MyButton : public QWidget
{
Q_OBJECT
public:
explicit MyButton(QWidget *parent = nullptr);

signals:
void sigClicked();
void sigClicked(bool check);
};
connect(m_pBtn,&MyButton::sigClicked,this,&Widget::onClicked);
这个看起来和之前的版本很类似，因此很容易迁移到新的语法。下面我们看看新语法有什么好处：

如果把 signal 或者 slot 名字编写错误，或者 slot 的参数同 signal 不一致，你会在编译期就获得一个错误。这肯定会在重构、或者修改 signal 或 slot 的名字时节省很多时间。但是存在一些坑需要注意，假设我将信号重载的话，会报错下面的错误：

error: no matching member function for call to 'connect' connect(m_pBtn,&MyButton::sigClicked,this,&Widget::onClicked);
^~~~~~~
因为我们自定义的 Button 中存在两个重载信号，然后用这种 connect 的方式会无法识别到底想要连接哪个信号。所以，如果信号是重载的话，需要用下面的写法来替换：

connect(m_pBtn, static_cast<void (MyButton::*)(bool)>(&MyButton::sigClicked), this, &Widget::onClicked);
问题又来了，如果我的onClicked槽也是重载的话，还是会报同样的错误。因为编译器不知道你想要真正连接哪个槽。所以这里建议，如果信号重载，可以用上面的方法来写，如果槽重载…还是用第一种方法来 connect 吧，比较保险，虽然比较麻烦点。

另一个好处：参数的自动类型转换

我们不仅可以更好地使用 typedef 或 namespace，而且可以利用隐式类型转换。在下面的例子中，我们的 signal 有一个QString参数，而 slot 需要的是QVariant。在新语法中，QString将被自动转换成QVariant

更进一步，我们可以将 signal 连接到任意函数：

static void someFunction() {
qDebug() << "pressed";
}

// ... somewhere else
QObject::connect(button, &QPushButton::clicked, someFunction);
信号与槽还有一个自动连接操作：

例如：on_pushButton_clicked()由on、部件的objextName和信号3部分组成，中间由下划线隔开，这样组织的名称的槽就可以直接和信号关联，而不用使用connect函数，不过这种方式还需要进行其他设置，而前面之所以可以直接使用，是因为程序中默认设置过了，在在程序开头ui->setupUi(this)就是调用connectSlotsByNmae()函数支持信号与槽的自动关联的，

QMetaObject::connectSlotsByName(this);

所以我们要在setupUI之前设置好对象名

QPushButton *button = new QPushButton(this);
button->setObjectName("myButton");//指定按钮的对象名
ui->setupUi(this);
然后你

//使用自动关联,此处就是指定按钮的对象名，一定要相同
void QMainWindow::on_myButton_clicked()
{
close();
}
方法还有很多种，常用的就这样啦