| Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/corelib/statemachine/qabstractstate.cpp |
| Source code | Switch to Preprocessed file |
| Line | Source | Count | ||||||
|---|---|---|---|---|---|---|---|---|
| 1 | /**************************************************************************** | - | ||||||
| 2 | ** | - | ||||||
| 3 | ** Copyright (C) 2015 The Qt Company Ltd. | - | ||||||
| 4 | ** Contact: http://www.qt.io/licensing/ | - | ||||||
| 5 | ** | - | ||||||
| 6 | ** This file is part of the QtCore module of the Qt Toolkit. | - | ||||||
| 7 | ** | - | ||||||
| 8 | ** $QT_BEGIN_LICENSE:LGPL21$ | - | ||||||
| 9 | ** Commercial License Usage | - | ||||||
| 10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||
| 11 | ** accordance with the commercial license agreement provided with the | - | ||||||
| 12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||
| 13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||
| 14 | ** and conditions see http://www.qt.io/terms-conditions. For further | - | ||||||
| 15 | ** information use the contact form at http://www.qt.io/contact-us. | - | ||||||
| 16 | ** | - | ||||||
| 17 | ** GNU Lesser General Public License Usage | - | ||||||
| 18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||
| 19 | ** General Public License version 2.1 or version 3 as published by the Free | - | ||||||
| 20 | ** Software Foundation and appearing in the file LICENSE.LGPLv21 and | - | ||||||
| 21 | ** LICENSE.LGPLv3 included in the packaging of this file. Please review the | - | ||||||
| 22 | ** following information to ensure the GNU Lesser General Public License | - | ||||||
| 23 | ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and | - | ||||||
| 24 | ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - | ||||||
| 25 | ** | - | ||||||
| 26 | ** As a special exception, The Qt Company gives you certain additional | - | ||||||
| 27 | ** rights. These rights are described in The Qt Company LGPL Exception | - | ||||||
| 28 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - | ||||||
| 29 | ** | - | ||||||
| 30 | ** $QT_END_LICENSE$ | - | ||||||
| 31 | ** | - | ||||||
| 32 | ****************************************************************************/ | - | ||||||
| 33 | - | |||||||
| 34 | #include "qabstractstate.h" | - | ||||||
| 35 | - | |||||||
| 36 | #ifndef QT_NO_STATEMACHINE | - | ||||||
| 37 | - | |||||||
| 38 | #include "qabstractstate_p.h" | - | ||||||
| 39 | #include "qstate.h" | - | ||||||
| 40 | #include "qstate_p.h" | - | ||||||
| 41 | #include "qstatemachine.h" | - | ||||||
| 42 | #include "qstatemachine_p.h" | - | ||||||
| 43 | - | |||||||
| 44 | QT_BEGIN_NAMESPACE | - | ||||||
| 45 | - | |||||||
| 46 | /*! | - | ||||||
| 47 | \class QAbstractState | - | ||||||
| 48 | \inmodule QtCore | - | ||||||
| 49 | - | |||||||
| 50 | \brief The QAbstractState class is the base class of states of a QStateMachine. | - | ||||||
| 51 | - | |||||||
| 52 | \since 4.6 | - | ||||||
| 53 | \ingroup statemachine | - | ||||||
| 54 | - | |||||||
| 55 | The QAbstractState class is the abstract base class of states that are part | - | ||||||
| 56 | of a QStateMachine. It defines the interface that all state objects have in | - | ||||||
| 57 | common. QAbstractState is part of \l{The State Machine Framework}. | - | ||||||
| 58 | - | |||||||
| 59 | The entered() signal is emitted when the state has been entered. The | - | ||||||
| 60 | exited() signal is emitted when the state has been exited. | - | ||||||
| 61 | - | |||||||
| 62 | The parentState() function returns the state's parent state. The machine() | - | ||||||
| 63 | function returns the state machine that the state is part of. | - | ||||||
| 64 | - | |||||||
| 65 | \section1 Subclassing | - | ||||||
| 66 | - | |||||||
| 67 | The onEntry() function is called when the state is entered; reimplement this | - | ||||||
| 68 | function to perform custom processing when the state is entered. | - | ||||||
| 69 | - | |||||||
| 70 | The onExit() function is called when the state is exited; reimplement this | - | ||||||
| 71 | function to perform custom processing when the state is exited. | - | ||||||
| 72 | */ | - | ||||||
| 73 | - | |||||||
| 74 | /*! | - | ||||||
| 75 | \property QAbstractState::active | - | ||||||
| 76 | \since 5.4 | - | ||||||
| 77 | - | |||||||
| 78 | \brief the active property of this state. A state is active between | - | ||||||
| 79 | entered() and exited() signals. | - | ||||||
| 80 | */ | - | ||||||
| 81 | - | |||||||
| 82 | - | |||||||
| 83 | QAbstractStatePrivate::QAbstractStatePrivate(StateType type) | - | ||||||
| 84 | : stateType(type), isMachine(false), active(false), parentState(0) | - | ||||||
| 85 | { | - | ||||||
| 86 | } executed 610 times by 2 tests: end of blockExecuted by:
| 610 | ||||||
| 87 | - | |||||||
| 88 | QStateMachine *QAbstractStatePrivate::machine() const | - | ||||||
| 89 | { | - | ||||||
| 90 | QObject *par = parent; | - | ||||||
| 91 | while (par != 0) {
| 93-403985 | ||||||
| 92 | if (QStateMachine *mach = qobject_cast<QStateMachine*>(par))
| 1630-402355 | ||||||
| 93 | return mach; executed 400811 times by 2 tests: return mach;Executed by:
| 400811 | ||||||
| 94 | par = par->parent(); | - | ||||||
| 95 | } executed 1630 times by 2 tests: end of blockExecuted by:
| 1630 | ||||||
| 96 | return 0; executed 93 times by 2 tests: return 0;Executed by:
| 93 | ||||||
| 97 | } | - | ||||||
| 98 | - | |||||||
| 99 | void QAbstractStatePrivate::callOnEntry(QEvent *e) | - | ||||||
| 100 | { | - | ||||||
| 101 | Q_Q(QAbstractState); | - | ||||||
| 102 | q->onEntry(e); | - | ||||||
| 103 | } executed 1507 times by 2 tests: end of blockExecuted by:
| 1507 | ||||||
| 104 | - | |||||||
| 105 | void QAbstractStatePrivate::callOnExit(QEvent *e) | - | ||||||
| 106 | { | - | ||||||
| 107 | Q_Q(QAbstractState); | - | ||||||
| 108 | q->onExit(e); | - | ||||||
| 109 | } executed 1298 times by 2 tests: end of blockExecuted by:
| 1298 | ||||||
| 110 | - | |||||||
| 111 | void QAbstractStatePrivate::emitEntered() | - | ||||||
| 112 | { | - | ||||||
| 113 | Q_Q(QAbstractState); | - | ||||||
| 114 | emit q->entered(QAbstractState::QPrivateSignal()); | - | ||||||
| 115 | if (!active) {
| 0-1507 | ||||||
| 116 | active = true; | - | ||||||
| 117 | emit q->activeChanged(true); | - | ||||||
| 118 | } executed 1507 times by 2 tests: end of blockExecuted by:
| 1507 | ||||||
| 119 | } executed 1507 times by 2 tests: end of blockExecuted by:
| 1507 | ||||||
| 120 | - | |||||||
| 121 | void QAbstractStatePrivate::emitExited() | - | ||||||
| 122 | { | - | ||||||
| 123 | Q_Q(QAbstractState); | - | ||||||
| 124 | if (active) {
| 0-1298 | ||||||
| 125 | active = false; | - | ||||||
| 126 | emit q->activeChanged(false); | - | ||||||
| 127 | } executed 1298 times by 2 tests: end of blockExecuted by:
| 1298 | ||||||
| 128 | emit q->exited(QAbstractState::QPrivateSignal()); | - | ||||||
| 129 | } executed 1298 times by 2 tests: end of blockExecuted by:
| 1298 | ||||||
| 130 | - | |||||||
| 131 | /*! | - | ||||||
| 132 | Constructs a new state with the given \a parent state. | - | ||||||
| 133 | */ | - | ||||||
| 134 | QAbstractState::QAbstractState(QState *parent) | - | ||||||
| 135 | : QObject(*new QAbstractStatePrivate(QAbstractStatePrivate::AbstractState), parent) | - | ||||||
| 136 | { | - | ||||||
| 137 | } never executed: end of block | 0 | ||||||
| 138 | - | |||||||
| 139 | /*! | - | ||||||
| 140 | \internal | - | ||||||
| 141 | */ | - | ||||||
| 142 | QAbstractState::QAbstractState(QAbstractStatePrivate &dd, QState *parent) | - | ||||||
| 143 | : QObject(dd, parent) | - | ||||||
| 144 | { | - | ||||||
| 145 | } executed 610 times by 2 tests: end of blockExecuted by:
| 610 | ||||||
| 146 | - | |||||||
| 147 | /*! | - | ||||||
| 148 | Destroys this state. | - | ||||||
| 149 | */ | - | ||||||
| 150 | QAbstractState::~QAbstractState() | - | ||||||
| 151 | { | - | ||||||
| 152 | } | - | ||||||
| 153 | - | |||||||
| 154 | /*! | - | ||||||
| 155 | Returns this state's parent state, or 0 if the state has no parent state. | - | ||||||
| 156 | */ | - | ||||||
| 157 | QState *QAbstractState::parentState() const | - | ||||||
| 158 | { | - | ||||||
| 159 | Q_D(const QAbstractState); | - | ||||||
| 160 | if (d->parentState != parent())
| 437-26240 | ||||||
| 161 | d->parentState = qobject_cast<QState*>(parent()); executed 437 times by 2 tests: d->parentState = qobject_cast<QState*>(parent());Executed by:
| 437 | ||||||
| 162 | return d->parentState; executed 26677 times by 2 tests: return d->parentState;Executed by:
| 26677 | ||||||
| 163 | } | - | ||||||
| 164 | - | |||||||
| 165 | /*! | - | ||||||
| 166 | Returns the state machine that this state is part of, or 0 if the state is | - | ||||||
| 167 | not part of a state machine. | - | ||||||
| 168 | */ | - | ||||||
| 169 | QStateMachine *QAbstractState::machine() const | - | ||||||
| 170 | { | - | ||||||
| 171 | Q_D(const QAbstractState); | - | ||||||
| 172 | return d->machine(); executed 401452 times by 2 tests: return d->machine();Executed by:
| 401452 | ||||||
| 173 | } | - | ||||||
| 174 | - | |||||||
| 175 | /*! | - | ||||||
| 176 | Returns whether this state is active. | - | ||||||
| 177 | - | |||||||
| 178 | \sa activeChanged(bool), entered(), exited() | - | ||||||
| 179 | */ | - | ||||||
| 180 | bool QAbstractState::active() const | - | ||||||
| 181 | { | - | ||||||
| 182 | Q_D(const QAbstractState); | - | ||||||
| 183 | return d->active; executed 644 times by 1 test: return d->active;Executed by:
| 644 | ||||||
| 184 | } | - | ||||||
| 185 | - | |||||||
| 186 | /*! | - | ||||||
| 187 | \fn QAbstractState::onExit(QEvent *event) | - | ||||||
| 188 | - | |||||||
| 189 | This function is called when the state is exited. The given \a event is what | - | ||||||
| 190 | caused the state to be exited. Reimplement this function to perform custom | - | ||||||
| 191 | processing when the state is exited. | - | ||||||
| 192 | */ | - | ||||||
| 193 | - | |||||||
| 194 | /*! | - | ||||||
| 195 | \fn QAbstractState::onEntry(QEvent *event) | - | ||||||
| 196 | - | |||||||
| 197 | This function is called when the state is entered. The given \a event is | - | ||||||
| 198 | what caused the state to be entered. Reimplement this function to perform | - | ||||||
| 199 | custom processing when the state is entered. | - | ||||||
| 200 | */ | - | ||||||
| 201 | - | |||||||
| 202 | /*! | - | ||||||
| 203 | \fn QAbstractState::entered() | - | ||||||
| 204 | - | |||||||
| 205 | This signal is emitted when the state has been entered (after onEntry() has | - | ||||||
| 206 | been called). | - | ||||||
| 207 | */ | - | ||||||
| 208 | - | |||||||
| 209 | /*! | - | ||||||
| 210 | \fn QAbstractState::exited() | - | ||||||
| 211 | - | |||||||
| 212 | This signal is emitted when the state has been exited (after onExit() has | - | ||||||
| 213 | been called). | - | ||||||
| 214 | */ | - | ||||||
| 215 | - | |||||||
| 216 | /*! | - | ||||||
| 217 | \fn QAbstractState::activeChanged(bool active) | - | ||||||
| 218 | \since 5.4 | - | ||||||
| 219 | - | |||||||
| 220 | This signal is emitted when the active property is changed with \a active as argument. | - | ||||||
| 221 | - | |||||||
| 222 | \sa QAbstractState::active, entered(), exited() | - | ||||||
| 223 | */ | - | ||||||
| 224 | - | |||||||
| 225 | /*! | - | ||||||
| 226 | \reimp | - | ||||||
| 227 | */ | - | ||||||
| 228 | bool QAbstractState::event(QEvent *e) | - | ||||||
| 229 | { | - | ||||||
| 230 | return QObject::event(e); executed 1166 times by 2 tests: return QObject::event(e);Executed by:
| 1166 | ||||||
| 231 | } | - | ||||||
| 232 | - | |||||||
| 233 | QT_END_NAMESPACE | - | ||||||
| 234 | - | |||||||
| 235 | #endif //QT_NO_STATEMACHINE | - | ||||||
| Source code | Switch to Preprocessed file |