Qt之QObject::blockSignals函数的使用和理解

最新推荐文章于 2025-09-05 10:06:58 发布

原创最新推荐文章于 2025-09-05 10:06:58 发布 · 3.6k 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#qt #开发语言

Qt 专栏收录该内容

36 篇文章

订阅专栏

本文介绍了如何在Qt中通过blockSignals函数来临时阻止对象信号的发送，避免影响后续操作。演示了如何在Widget类中使用这个功能，并提到了disconect和connect的替代应用。

在某些业务下，需要阻塞住对象某个信号的发送，避免它触发对应的槽影响到后续的操作。可以通过bool QObject::blockSignals(bool block)来做简单的处理。

从qt的帮助文档可以了解到，如果blockSignals(bool block)的参数block设置为true，那么信号的发送会被阻塞，反之不会阻塞。而且被阻塞时，发出的信号不会被缓存。即使对象的信号被阻塞住，也对destroyed()信号没有影响。

可以通过signalsBlocked()函数来判断某个对象的信号是否被阻塞。

下面是一个简单的demo：

当设置了阻塞后，updateText按钮将无法改变label的值。只有取消阻塞以后才可以使得槽生效。

/////////////////////////////////.h
#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();

public slots:
    void onPushButtonClicked();
    void onSetBlockedSignalStatus();

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H


/////////////////////////////////cpp
#include "widget.h"
#include "ui_widget.h"
#include <QMetaMethod>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    connect(ui->pushButton,SIGNAL(clicked()),this,SLOT(onPushButtonClicked()));
    connect(ui->pushButton_2,SIGNAL(clicked()),this,SLOT(onSetBlockedSignalStatus()));
    ui->pushButton->blockSignals(true);
}

Widget::~Widget()
{
    delete ui;
}

void Widget::onPushButtonClicked()
{
    ui->label->setText("Hello Qt");
}

void Widget::onSetBlockedSignalStatus()
{
    if(ui->pushButton->signalsBlocked())
    {
        ui->label_2->setText("blockSignals(false)");
        ui->pushButton->blockSignals(false);    //不阻塞信号
        return;
    }
    ui->label->setText("TextLabel");
    ui->label_2->setText("blockSignals(true)");
    ui->pushButton->blockSignals(true); //阻塞信号
}

除了使用bool QObject::blockSignals(bool block)函数，还可以使用disconnect函数暂时断开信号和对应槽的连接，等处理完业务再connect上，当然频繁的disconnect和connect并不友好，更推荐使用blockSignals。