QFinalState Class

The QFinalState class provides a final state. More...

Header: #include <QFinalState>
qmake: QT += core
Since: Qt 4.6
Inherits: QAbstractState

Public Functions

QFinalState(QState *parent = Q_NULLPTR)
~QFinalState()

Reimplemented Protected Functions

virtual bool event(QEvent *e)
virtual void onEntry(QEvent *event)
virtual void onExit(QEvent *event)

Additional Inherited Members

Detailed Description

The QFinalState class provides a final state.

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 = Q_NULLPTR)

Constructs a new QFinalState object with the given parent state.

QFinalState::~QFinalState()

Destroys this final state.

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

Reimplemented from QObject::event().

[virtual protected] void QFinalState::onEntry(QEvent *event)

Reimplemented from QAbstractState::onEntry().

[virtual protected] void QFinalState::onExit(QEvent *event)

Reimplemented from QAbstractState::onExit().

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