The QEventTransition class provides a QObject-specific transition for Qt events. More...
Header: | #include <QEventTransition> |
CMake: | find_package(Qt6 COMPONENTS StateMachine REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::StateMachine) |
qmake: | QT += statemachine |
Inherits: | QAbstractTransition |
Inherited By: |
QEventTransition(QObject *object, QEvent::Type type, QState *sourceState = nullptr) | |
QEventTransition(QState *sourceState = nullptr) | |
virtual | ~QEventTransition() |
QObject * | eventSource() const |
QEvent::Type | eventType() const |
void | setEventSource(QObject *object) |
void | setEventType(QEvent::Type type) |
virtual bool | event(QEvent *e) override |
virtual bool | eventTest(QEvent *event) override |
virtual void | onTransition(QEvent *event) override |
A QEventTransition object binds an event to a particular QObject. QEventTransition is part of Qt State Machine Framework.
Example:
QPushButton *button = ...; QState *s1 = ...; QState *s2 = ...; // If in s1 and the button receives an Enter event, transition to s2 QEventTransition *enterTransition = new QEventTransition(button, QEvent::Enter); enterTransition->setTargetState(s2); s1->addTransition(enterTransition); // If in s2 and the button receives an Exit event, transition back to s1 QEventTransition *leaveTransition = new QEventTransition(button, QEvent::Leave); leaveTransition->setTargetState(s1); s2->addTransition(leaveTransition);
When reimplementing the eventTest() function, you should first call the base implementation to verify that the event is a QStateMachine::WrappedEvent for the proper object and event type. You may then cast the event to a QStateMachine::WrappedEvent and get the original event by calling QStateMachine::WrappedEvent::event(), and perform additional checks on that object.
See also QState::addTransition().
[bindable]
eventSource : QObject*
Note: This property supports QProperty bindings.
This property holds the event source that this event transition is associated with
[bindable]
eventType : QEvent::Type
Note: This property supports QProperty bindings.
This property holds the type of event that this event transition is associated with
Constructs a new QEventTransition object associated with events of the given type for the given object, and with the given sourceState.
Constructs a new QEventTransition object with the given sourceState.
[virtual]
QEventTransition::~QEventTransition()
Destroys this QObject event transition.
[override virtual protected]
bool QEventTransition::event(QEvent *e)
Reimplements: QAbstractTransition::event(QEvent *e).
Returns the event source associated with this event transition.
Note: Getter function for property eventSource.
See also setEventSource().
[override virtual protected]
bool QEventTransition::eventTest(QEvent *event)
Reimplements: QAbstractTransition::eventTest(QEvent *event).
Returns the event type that this event transition is associated with.
Note: Getter function for property eventType.
See also setEventType().
[override virtual protected]
void QEventTransition::onTransition(QEvent *event)
Reimplements: QAbstractTransition::onTransition(QEvent *event).
Sets the event source associated with this event transition to be the given object.
Note: Setter function for property eventSource.
See also eventSource().
Sets the event type that this event transition is associated with.
Note: Setter function for property eventType.
See also eventType().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qeventtransition.html