槽函数被执行多次的解决方法及Qt::UniqueConnection作用及和其它连接类型的“与”操作写法

原创已于 2024-03-25 11:40:20 修改 · 3.4k 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#qt #信号 #槽

于 2022-02-27 12:11:55 首次发布

Qt平时遇到的疑难点专栏收录该内容

145 篇文章

订阅专栏

本文详细解析了在Qt中信号槽机制导致的槽函数被多次执行的问题。当信号被多次connect到同一个槽函数时，槽会被执行相应次数。解决方法包括使用Qt::UniqueConnection防止重复连接，或先disconnect再connect。此外，还提醒了Qt的默认信号槽连接规则，可能导致函数被自动执行。

今天在项目中发现发送一次信号，槽函数被执行多次，如下：

connect(pBtn, &QAbstractButton::clicked, this, &QtWidgetsApplication2::btnClicked);

pBtn为按钮。上述代码在一个循环中被连接信号槽多次，单击一次pBtn按钮，槽函数QtWidgetsApplication2::btnClicked被响应了多次。我原以为connect会将上次连接的信号槽覆盖掉，看来这货是每次累加啊，即connect几次就发送几次。解决方法有两种：

1.在最后一个参数加入Qt::UniqueConnection，如下：

connect(ui.btn, &QAbstractButton::clicked, this, &QtWidgetsApplication2::btnClicked, Qt::UniqueConnection);

或者：

connect(ui.btn, &QAbstractButton::clicked, this, &QtWidgetsApplication2::btnClicked, (Qt::ConnectionType)( type | Qt::UniqueConnection));

注意：上面的最后一个参数不能为下面那样的写法，否则编译报错：

type | Qt::UniqueConnection

其中type为Qt::AutoConnection、Qt::DirectConnection、Qt::QueuedConnection、Qt::BlockingQueuedConnection中的某一个类型。Qt::UniqueConnection的作用是：如果该信号以前没连接过，则连接它，返回true，如果以前连接过，则不再连接，返回false。

2.用disconnect函数先断开连接，再重新connect

如下：


QMetaObject::Connection connectHandler = connect(pBtn, &QAbstractButton::clicked, this, &QtWidgetsApplication2::btnClicked);

// 先断开连接
disconnect(connectHandler); 

// 重新连接
connect(pBtn, &QAbstractButton::clicked, this, &QtWidgetsApplication2::btnClicked);

另外如下也会执行多次：

connect(ui.pushButtonSwitch, SIGNAL(clicked(bool)), this, SLOT(on_pushButtonSwitch_clicked(bool)));

其中on_pushButtonSwitch_clicked(bool)函数的命名是on_对象名_signal名的规则，而这正是Qt的信号-槽默认的连接规则，也就是说你不对按钮进行任何connect时，而仅仅只是把槽函数写成on_对象名_signal形式，qt也会自动执行该函数，一旦你connect了按钮的clicked信号但响应clicked信号的槽函数命名不是on_对象名_signal名的规则，那么qt就不会自动执行on_对象名_signal名的规则函数，转而执行你定义的槽函数。上面代码connect信号到qt默认的信号-槽默认连接规则的槽函数上，且槽函数命名是on_对象名_signal名的规则，所以qt会执行两次，一次是connect连接的，一次是qt默认的（默认的槽函数和你conenct连接的槽函数相同，所以执行了两次）