Класс QSignalBlocker

Обёртка с безопасностью исключений вокруг QObject::blockSignals(). Подробнее...

Этот класс был представлен в Qt 5.3.

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются повторно входящими.

Открытые функции

Подробное описание

QSignalBlocker может использоваться везде, где вы бы в противном случае использовали пару вызовов blockSignals(). Он блокирует сигналы в конструкторе и в деструкторе сбрасывает состояние к тому, что было до выполнения конструктора.

{
const QSignalBlocker blocker(someQObject);
// no signals here
}

Таким образом, эквивалентно

const bool wasBlocked = someQObject->blockSignals(true);
// no signals here
someQObject->blockSignals(wasBlocked);

кроме того, что код, использующий QSignalBlocker, безопасен при возникновении исключений.

См. также QMutexLocker и QEventLoopLocker.

Документация по функциям-членам

QSignalBlocker::QSignalBlocker(QSignalBlocker &&other)

Перемещающее создание блокировщика сигналов из other. other будет иметь деструктор без действий, в то время как ответственность за восстановление состояния QObject::signalsBlocked() передаётся новому объекту.

QSignalBlocker::QSignalBlocker(QObject &object)

Это перегруженная функция.

Вызывает object.blockSignals(true).

QSignalBlocker::QSignalBlocker(QObject *object)

Конструктор. Вызывает object->blockSignals(true).

QSignalBlocker &QSignalBlocker::operator=(QSignalBlocker &&other)

Перемещающее присваивание этому блокировщику сигналов из other. other будет иметь деструктор без действий, в то время как ответственность за восстановление состояния QObject::signalsBlocked() передаётся этому объекту.

Сигналы объекта, которые блокировал этот блокировщик сигналов до перемещения, если таковые имеются, разблокируются, за исключением случая, когда оба экземпляра блокируют сигналы одного и того же объекта, и *this разблокируется, а other нет, в момент перемещения.

QSignalBlocker::~QSignalBlocker()

Деструктор. Восстанавливает состояние QObject::signalsBlocked() до того, что было до запуска конструктора, если не было вызвано unblock() без последующего reblock(), в этом случае он ничего не делает.

void QSignalBlocker::reblock()

Блокирует сигналы повторно после предыдущего unblock().

Количество вызовов reblock() и unblock() не учитывается, поэтому каждый вызов reblock() отменяет любое количество вызовов unblock().

void QSignalBlocker::unblock()

Временное восстановление состояния QObject::signalsBlocked() до состояния до запуска конструктора этого QSignalBlocker. Для отмены используйте reblock().

Количество вызовов reblock() и unblock() не учитывается, поэтому каждый вызов unblock() отменяет любое количество вызовов reblock().