Класс QSignalBlocker

Безопасная по отношению к исключениям оболочка вокруг QObject::blockSignals() Подробнее...

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

Примечание: Все функции в этом классе являются реентерабельными.

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

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

Безопасная по отношению к исключениям оболочка вокруг QObject::blockSignals()

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(QObject *object)

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

QSignalBlocker::QSignalBlocker(QObject &object)

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

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

QSignalBlocker::QSignalBlocker(QSignalBlocker &&other)

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

QSignalBlocker::~QSignalBlocker()

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

void QSignalBlocker::reblock()

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

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

void QSignalBlocker::unblock()

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

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

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

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

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