En esta página

QSignalBlocker Class

Envoltura a prueba de excepciones para la función ` QObject::blockSignals()`. Más información...

Encabezado: #include <QSignalBlocker>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QSignalBlocker(QObject *object)
QSignalBlocker(QObject &object)
QSignalBlocker(QSignalBlocker &&other)
~QSignalBlocker()
(since 6.7) void dismiss()
void reblock()
void unblock()
QSignalBlocker &operator=(QSignalBlocker &&other)

Descripción detallada

QSignalBlocker se puede utilizar en cualquier situación en la que, de otro modo, se emplearía un par de llamadas a QObject::blockSignals(). Bloquea las señales en su constructor y, en el destructor, restablece el estado al que tenía antes de que se ejecutara el constructor.

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

Por lo tanto, es equivalente a

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

, salvo que el código que utiliza QSignalBlocker es seguro ante excepciones.

Véase también QMutexLocker y QEventLoopLocker.

Documentación de las funciones miembro

[explicit noexcept] QSignalBlocker::QSignalBlocker(QObject *object)

Constructor. Llama a ` object` -> `blockSignals(true)`.

[explicit noexcept] QSignalBlocker::QSignalBlocker(QObject &object)

Llama a ` object.blockSignals(true)`.

Se trata de una función sobrecargada.

[noexcept] QSignalBlocker::QSignalBlocker(QSignalBlocker &&other)

Crea un bloqueador de señales a partir de other. other tendrá un destructor que no realiza ninguna operación, mientras que la responsabilidad de restaurar el estado de QObject::signalsBlocked() se transfiere al nuevo objeto.

[noexcept] QSignalBlocker::~QSignalBlocker()

Destructor. Restablece el estado de ` QObject::signalsBlocked()` tal y como estaba antes de que se ejecutara el constructor, a menos que se haya llamado a ` unblock()` sin que le siga ` reblock()`, en cuyo caso no hace nada.

[noexcept, since 6.7] void QSignalBlocker::dismiss()

Descarga el objeto ` QSignalBlocker`. Ya no tendrá acceso a la clase ` QObject ` pasada a su constructor. Las funciones ` unblock()`, ` reblock()`, así como `~QSignalBlocker()` no tendrán ningún efecto.

Esta función se introdujo en Qt 6.7.

[noexcept] void QSignalBlocker::reblock()

Vuelve a bloquear las señales tras una llamada previa a ` unblock()`.

No se contabiliza el número de llamadas a reblock() ni a unblock(), por lo que cada llamada a reblock() anula cualquier número de llamadas a unblock().

[noexcept] void QSignalBlocker::unblock()

Restablece temporalmente el estado de QObject::signalsBlocked() tal y como estaba antes de que se ejecutara el constructor de QSignalBlocker. Para deshacerlo, utiliza reblock().

No se contabiliza el número de llamadas a ` reblock()` ni a `unblock()`, por lo que cada llamada a `unblock()` deshace cualquier número de llamadas a ` reblock()`.

[noexcept] QSignalBlocker &QSignalBlocker::operator=(QSignalBlocker &&other)

Asigna mediante «move» este bloqueador de señales desde other. other tendrá un destructor que no realiza ninguna operación, mientras que la responsabilidad de restaurar el estado de QObject::signalsBlocked() se transfiere a este objeto.

Las señales del objeto que este bloqueador de señales bloqueaba antes de ser trasladado, si las hubiera, quedan desbloqueadas, salvo en el caso de que ambas instancias bloqueen las señales del mismo objeto y *this esté desbloqueado mientras que other no lo esté en el momento del traslado.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.