1/****************************************************************************
2**
3** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4** Contact: http://www.qt-project.org/legal
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 Digia. For licensing terms and
14** conditions see http://qt.digia.com/licensing. For further information
15** use the contact form at http://qt.digia.com/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 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 2.1 requirements
23** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24**
25** In addition, as a special exception, Digia gives you certain additional
26** rights. These rights are described in the Digia Qt LGPL Exception
27** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28**
29** GNU General Public License Usage
30** Alternatively, this file may be used under the terms of the GNU
31** General Public License version 3.0 as published by the Free Software
32** Foundation and appearing in the file LICENSE.GPL included in the
33** packaging of this file. Please review the following information to
34** ensure the GNU General Public License version 3.0 requirements will be
35** met: http://www.gnu.org/copyleft/gpl.html.
36**
37**
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef QABSTRACTTRANSITION_H
43#define QABSTRACTTRANSITION_H
44
45#include <QtCore/qobject.h>
46
47#include <QtCore/qlist.h>
48
49QT_BEGIN_HEADER
50
51QT_BEGIN_NAMESPACE
52
53QT_MODULE(Core)
54
55#ifndef QT_NO_STATEMACHINE
56
57class QEvent;
58class QAbstractState;
59class QState;
60class QStateMachine;
61
62#ifndef QT_NO_ANIMATION
63class QAbstractAnimation;
64#endif
65
66class QAbstractTransitionPrivate;
67class Q_CORE_EXPORT QAbstractTransition : public QObject
68{
69 Q_OBJECT
70 Q_PROPERTY(QState* sourceState READ sourceState)
71 Q_PROPERTY(QAbstractState* targetState READ targetState WRITE setTargetState)
72 Q_PROPERTY(QList<QAbstractState*> targetStates READ targetStates WRITE setTargetStates)
73public:
74 QAbstractTransition(QState *sourceState = 0);
75 virtual ~QAbstractTransition();
76
77 QState *sourceState() const;
78 QAbstractState *targetState() const;
79 void setTargetState(QAbstractState* target);
80 QList<QAbstractState*> targetStates() const;
81 void setTargetStates(const QList<QAbstractState*> &targets);
82
83 QStateMachine *machine() const;
84
85#ifndef QT_NO_ANIMATION
86 void addAnimation(QAbstractAnimation *animation);
87 void removeAnimation(QAbstractAnimation *animation);
88 QList<QAbstractAnimation*> animations() const;
89#endif
90
91Q_SIGNALS:
92#if !defined(Q_MOC_RUN) && !defined(qdoc)
93private: // can only be emitted by QAbstractTransition
94#endif
95 void triggered();
96
97protected:
98 virtual bool eventTest(QEvent *event) = 0;
99
100 virtual void onTransition(QEvent *event) = 0;
101
102 bool event(QEvent *e);
103
104protected:
105 QAbstractTransition(QAbstractTransitionPrivate &dd, QState *parent);
106
107private:
108 Q_DISABLE_COPY(QAbstractTransition)
109 Q_DECLARE_PRIVATE(QAbstractTransition)
110};
111
112#endif //QT_NO_STATEMACHINE
113
114QT_END_NAMESPACE
115
116QT_END_HEADER
117
118#endif
119