QFinalState Class
The QFinalState class provides a final state. More...
Header: | #include <QFinalState> |
qmake: | QT += core |
Since: | Qt 4.6 |
Inherits: | QAbstractState |
This class was introduced in Qt 4.6.
Public Functions
QFinalState(QState *parent = nullptr) | |
virtual | ~QFinalState() |
- 3 public functions inherited from QAbstractState
- 31 public functions inherited from QObject
Reimplemented Protected Functions
virtual bool | event(QEvent *e) override |
virtual void | onEntry(QEvent *event) override |
virtual void | onExit(QEvent *event) override |
- 3 protected functions inherited from QAbstractState
- 9 protected functions inherited from QObject
Related Non-Members
typedef | QObjectList |
QList<T> | qFindChildren(const QObject *obj, const QRegExp ®Exp) |
T | qobject_cast(QObject *object) |
T | qobject_cast(const QObject *object) |
Macros
QT_NO_NARROWING_CONVERSIONS_IN_CONNECT | |
Q_CLASSINFO(Name, Value) | |
Q_DISABLE_COPY(Class) | |
Q_DISABLE_COPY_MOVE(Class) | |
Q_DISABLE_MOVE(Class) | |
Q_EMIT | |
Q_ENUM(...) | |
Q_ENUM_NS(...) | |
Q_FLAG(...) | |
Q_FLAG_NS(...) | |
Q_GADGET | |
Q_INTERFACES(...) | |
Q_INVOKABLE | |
Q_NAMESPACE | |
Q_OBJECT | |
Q_PROPERTY(...) | |
Q_REVISION | |
Q_SET_OBJECT_NAME(Object) | |
Q_SIGNAL | |
Q_SIGNALS | |
Q_SLOT | |
Q_SLOTS |
Additional Inherited Members
- 1 property inherited from QAbstractState
- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 3 signals inherited from QAbstractState
- 2 signals inherited from QObject
- 10 static public members inherited from QObject
- 3 protected functions inherited from QAbstractState
- 9 protected functions inherited from QObject
Detailed Description
A final state is used to communicate that (part of) a QStateMachine has finished its work. When a final top-level state is entered, the state machine's finished() signal is emitted. In general, when a final substate (a child of a QState) is entered, the parent state's finished() signal is emitted. QFinalState is part of The State Machine Framework.
To use a final state, you create a QFinalState object and add a transition to it from another state. Example:
QPushButton button; QStateMachine machine; QState *s1 = new QState(); QFinalState *s2 = new QFinalState(); s1->addTransition(&button, SIGNAL(clicked()), s2); machine.addState(s1); machine.addState(s2); QObject::connect(&machine, SIGNAL(finished()), QApplication::instance(), SLOT(quit())); machine.setInitialState(s1); machine.start();
See also QState::finished().
Member Function Documentation
QFinalState::QFinalState(QState *parent = nullptr)
Constructs a new QFinalState object with the given parent state.
[virtual]
QFinalState::~QFinalState()
Destroys this final state.
[override virtual protected]
bool QFinalState::event(QEvent *e)
Reimplements: QAbstractState::event(QEvent *e).
[override virtual protected]
void QFinalState::onEntry(QEvent *event)
Reimplements: QAbstractState::onEntry(QEvent *event).
[override virtual protected]
void QFinalState::onExit(QEvent *event)
Reimplements: QAbstractState::onExit(QEvent *event).