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