En esta página

QSignalTransition Class

La clase `QSignalTransition` proporciona una transición basada en una señal de Qt. Más información...

Encabezado: #include <QSignalTransition>
CMake: find_package(Qt6 REQUIRED COMPONENTS StateMachine)
target_link_libraries(mytarget PRIVATE Qt6::StateMachine)
qmake: QT += statemachine
Heredado de: QAbstractTransition

Propiedades

Funciones públicas

QSignalTransition(QState *sourceState = nullptr)
QSignalTransition(const QObject *sender, const char *signal, QState *sourceState = nullptr)
QSignalTransition(const QObject *sender, PointerToMemberFunction signal, QState *sourceState = nullptr)
virtual ~QSignalTransition()
QBindable<const QObject *> bindableSenderObject()
QBindable<QByteArray> bindableSignal()
const QObject *senderObject() const
void setSenderObject(const QObject *sender)
void setSignal(const QByteArray &signal)
QByteArray signal() const

Señales

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual bool eventTest(QEvent *event) override
virtual void onTransition(QEvent *event) override

Descripción detallada

Normalmente se utiliza la sobrecarga de ` QState::addTransition()` que toma un emisor y una señal como argumentos, en lugar de crear objetos `QSignalTransition` directamente. `QSignalTransition` forma parte del marco de trabajo «Qt State Machine ».

Se puede crear una subclase de QSignalTransition y reimplementar eventTest() para hacer que una transición de señal sea condicional; el objeto de evento pasado a eventTest() será un objeto QStateMachine::SignalEvent. Ejemplo:

class CheckedTransition : public QSignalTransition
{
public:
    CheckedTransition(QCheckBox *check)
        : QSignalTransition(check, SIGNAL(stateChanged(int))) {}
protected:
    bool eventTest(QEvent *e) {
        if (!QSignalTransition::eventTest(e))
            return false;
        QStateMachine::SignalEvent *se = static_cast<QStateMachine::SignalEvent*>(e);
        return (se->arguments().at(0).toInt() == Qt::Checked);
    }
};

...

QCheckBox *check = new QCheckBox();
check->setTristate(true);

QState *s1 = new QState();
QState *s2 = new QState();
CheckedTransition *t1 = new CheckedTransition(check);
t1->setTargetState(s2);
s1->addTransition(t1);

Documentación de la propiedad

[bindable] senderObject : const QObject*

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el objeto emisor al que está asociada esta transición de señal

Funciones de acceso:

const QObject *senderObject() const
void setSenderObject(const QObject *sender)

Señal de notificador:

void senderObjectChanged()[see note below]

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

[bindable] signal : QByteArray

Nota: Esta propiedad es compatible con los enlaces de « QProperty ».

Esta propiedad contiene la señal a la que está asociada esta transición de señal

Funciones de acceso:

QByteArray signal() const
void setSignal(const QByteArray &signal)

Señal de notificación:

void signalChanged()[see note below]

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Documentación de las funciones de miembro

QSignalTransition::QSignalTransition(QState *sourceState = nullptr)

Crea una nueva transición de señal con el ` sourceState` indicado.

QSignalTransition::QSignalTransition(const QObject *sender, const char *signal, QState *sourceState = nullptr)

Crea una nueva transición de señal asociada al signal especificado, al sender especificado y al sourceState especificado.

template <typename PointerToMemberFunction> QSignalTransition::QSignalTransition(const QObject *sender, PointerToMemberFunction signal, QState *sourceState = nullptr)

Crea una nueva transición de señal asociada al ` signal ` especificado del objeto ` sender ` dado y al ` sourceState` especificado. Este constructor está habilitado si el compilador admite constructores de delegación, tal y como indica la presencia de la macro `Q_COMPILER_DELEGATING_CONSTRUCTORS`.

Se trata de una función sobrecargada.

[virtual noexcept] QSignalTransition::~QSignalTransition()

Elimina esta transición de señal.

[override virtual protected] bool QSignalTransition::event(QEvent *e)

Reimplementa: QAbstractTransition::event(QEvent *e).

[override virtual protected] bool QSignalTransition::eventTest(QEvent *event)

Reimplementa: ` QAbstractTransition::eventTest` (`QEvent *event)`.

La implementación por defecto devuelve « true » si el « event » es un objeto « QStateMachine::SignalEvent » y el remitente del evento y el índice de la señal coinciden con esta transición; en caso contrario, devuelve « false ».

[override virtual protected] void QSignalTransition::onTransition(QEvent *event)

Reimplementa: QAbstractTransition::onTransition(QEvent *event).

const QObject *QSignalTransition::senderObject() const

Devuelve el objeto emisor asociado a esta transición de señal.

Nota: Funcióngetter para la propiedad senderObject.

Véase también ` setSenderObject()`.

[private signal] void QSignalTransition::senderObjectChanged()

Esta señal se emite cuando se modifica la propiedad « senderObject ».

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Nota: Señalde notificación para la propiedad ` senderObject`.

Véase también QSignalTransition::senderObject.

void QSignalTransition::setSenderObject(const QObject *sender)

Establece el objeto « sender » asociado a esta transición de señal.

Nota: Funciónde asignación para la propiedad senderObject.

Véase también senderObject().

void QSignalTransition::setSignal(const QByteArray &signal)

Establece el valor de « signal » asociado a esta transición de señal.

Nota: Funciónde asignación para la propiedad signal.

Véase también ` signal()`.

QByteArray QSignalTransition::signal() const

Devuelve la señal asociada a esta transición de señal.

Nota: Funcióngetter para la propiedad signal.

Véase también setSignal().

[private signal] void QSignalTransition::signalChanged()

Esta señal se emite cuando se modifica la propiedad de la señal.

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Nota: Señalde notificación para la propiedad « signal ».

Véase también QSignalTransition::signal.

© 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.