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
- senderObject : const QObject*
- signal : QByteArray
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
| void | senderObjectChanged() |
| void | signalChanged() |
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:
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.