blob: c4dbcc9783c8d4b9bb72b41b3e0707d1bd277a43 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** Contact: Qt Software Information (qt-info@nokia.com)
**
** This file is part of the $MODULE$ of the Qt Toolkit.
**
** $TROLLTECH_DUAL_LICENSE$
**
****************************************************************************/
#include "qfinalstate.h"
#include "qactionstate_p.h"
QT_BEGIN_NAMESPACE
/*!
\class QFinalState
\brief The QFinalState class provides a final state.
\ingroup statemachine
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 \l{QStateMachine::finished()}{finished}() signal is emitted. In
general, when a final substate (a child of a QState) is entered, a
QStateFinishedEvent is generated for the final state's parent
state. QFinalState is part of \l{The State Machine Framework}.
To use a final state, you create a QFinalState object and add a transition
to it from another state. Example:
\code
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();
\endcode
\sa QStateFinishedTransition
*/
class QFinalStatePrivate : public QActionStatePrivate
{
Q_DECLARE_PUBLIC(QFinalState)
public:
QFinalStatePrivate();
};
QFinalStatePrivate::QFinalStatePrivate()
{
}
/*!
Constructs a new QFinalState object with the given \a parent state.
*/
QFinalState::QFinalState(QState *parent)
: QActionState(*new QFinalStatePrivate, parent)
{
}
/*!
Destroys this final state.
*/
QFinalState::~QFinalState()
{
}
/*!
\reimp
*/
void QFinalState::onEntry()
{
QActionState::onEntry();
}
/*!
\reimp
*/
void QFinalState::onExit()
{
QActionState::onExit();
}
/*!
\reimp
*/
bool QFinalState::event(QEvent *e)
{
return QActionState::event(e);
}
QT_END_NAMESPACE
|
