Qt 4.8
Public Functions | Protected Functions | Properties | List of all members
QEventTransition Class Reference

The QEventTransition class provides a QObject-specific transition for Qt events. More...

#include <qeventtransition.h>

Inheritance diagram for QEventTransition:
QAbstractTransition QObject QKeyEventTransition QMouseEventTransition

Public Functions

QObjecteventSource () const
 
QEvent::Type eventType () const
 
 QEventTransition (QState *sourceState=0)
 Constructs a new QEventTransition object with the given sourceState. More...
 
 QEventTransition (QObject *object, QEvent::Type type, QState *sourceState=0)
 Constructs a new QEventTransition object associated with events of the given type for the given object, and with the given sourceState. More...
 
void setEventSource (QObject *object)
 Sets the event source associated with this event transition to be the given object. More...
 
void setEventType (QEvent::Type type)
 Sets the event type that this event transition is associated with. More...
 
 ~QEventTransition ()
 Destroys this QObject event transition. More...
 
- Public Functions inherited from QAbstractTransition
void addAnimation (QAbstractAnimation *animation)
 Adds the given animation to this transition. More...
 
QList< QAbstractAnimation * > animations () const
 Returns the list of animations associated with this transition, or an empty list if it has no animations. More...
 
QStateMachinemachine () const
 Returns the state machine that this transition is part of, or 0 if the transition is not part of a state machine. More...
 
 QAbstractTransition (QState *sourceState=0)
 Constructs a new QAbstractTransition object with the given sourceState. More...
 
void removeAnimation (QAbstractAnimation *animation)
 Removes the given animation from this transition. More...
 
void setTargetState (QAbstractState *target)
 Sets the target state of this transition. More...
 
void setTargetStates (const QList< QAbstractState *> &targets)
 Sets the target states of this transition to be the given targets. More...
 
QStatesourceState () const
 
QAbstractStatetargetState () const
 
QList< QAbstractState * > targetStates () const
 
virtual ~QAbstractTransition ()
 Destroys this transition. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
virtual const QMetaObjectmetaObject () const
 Returns a pointer to the meta-object of this object. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 

Protected Functions

bool event (QEvent *e)
 Reimplemented Function More...
 
bool eventTest (QEvent *event)
 Reimplemented Function More...
 
void onTransition (QEvent *event)
 Reimplemented Function More...
 
 QEventTransition (QEventTransitionPrivate &dd, QState *parent)
 
 QEventTransition (QEventTransitionPrivate &dd, QObject *object, QEvent::Type type, QState *parent)
 
- Protected Functions inherited from QAbstractTransition
 QAbstractTransition (QAbstractTransitionPrivate &dd, QState *parent)
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void connectNotify (const char *signal)
 This virtual function is called when something has been connected to signal in this object. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *)
 This event handler can be reimplemented in a subclass to receive timer events for the object. More...
 

Properties

QObjecteventSource
 the event source that this event transition is associated with More...
 
QEvent::Type eventType
 the type of event that this event transition is associated with More...
 

Additional Inherited Members

- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Signals inherited from QAbstractTransition
void triggered ()
 This signal is emitted when the transition has been triggered (after onTransition() has been called). More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QEventTransition class provides a QObject-specific transition for Qt events.

Since
4.6

A QEventTransition object binds an event to a particular QObject. QEventTransition is part of The State Machine Framework.

Example:

QPushButton *button = ...;
QState *s1 = ...;
QState *s2 = ...;
// If in s1 and the button receives an Enter event, transition to s2
QEventTransition *enterTransition = new QEventTransition(button, QEvent::Enter);
enterTransition->setTargetState(s2);
s1->addTransition(enterTransition);
// If in s2 and the button receives an Exit event, transition back to s1
QEventTransition *leaveTransition = new QEventTransition(button, QEvent::Leave);
leaveTransition->setTargetState(s1);
s2->addTransition(leaveTransition);

Subclassing

When reimplementing the eventTest() function, you should first call the base implementation to verify that the event is a QStateMachine::WrappedEvent for the proper object and event type. You may then cast the event to a QStateMachine::WrappedEvent and get the original event by calling QStateMachine::WrappedEvent::event(), and perform additional checks on that object.

See also
QState::addTransition()

Definition at line 57 of file qeventtransition.h.

Constructors and Destructors

◆ QEventTransition() [1/4]

QEventTransition::QEventTransition ( QState sourceState = 0)

Constructs a new QEventTransition object with the given sourceState.

Definition at line 145 of file qeventtransition.cpp.

146  : QAbstractTransition(*new QEventTransitionPrivate, sourceState)
147 {
148 }
QAbstractTransition(QState *sourceState=0)
Constructs a new QAbstractTransition object with the given sourceState.

◆ QEventTransition() [2/4]

QEventTransition::QEventTransition ( QObject object,
QEvent::Type  type,
QState sourceState = 0 
)

Constructs a new QEventTransition object associated with events of the given type for the given object, and with the given sourceState.

Definition at line 154 of file qeventtransition.cpp.

156  : QAbstractTransition(*new QEventTransitionPrivate, sourceState)
157 {
159  d->registered = false;
160  d->object = object;
161  d->eventType = type;
162 }
double d
Definition: qnumeric_p.h:62
int type
Definition: qmetatype.cpp:239
#define Q_D(Class)
Definition: qglobal.h:2482
The QEventTransition class provides a QObject-specific transition for Qt events.
QAbstractTransition(QState *sourceState=0)
Constructs a new QAbstractTransition object with the given sourceState.

◆ ~QEventTransition()

QEventTransition::~QEventTransition ( )

Destroys this QObject event transition.

Definition at line 188 of file qeventtransition.cpp.

189 {
190 }

◆ QEventTransition() [3/4]

QEventTransition::QEventTransition ( QEventTransitionPrivate dd,
QState parent 
)
protected
Warning
This function is not part of the public interface.

Definition at line 167 of file qeventtransition.cpp.

168  : QAbstractTransition(dd, parent)
169 {
170 }
QAbstractTransition(QState *sourceState=0)
Constructs a new QAbstractTransition object with the given sourceState.

◆ QEventTransition() [4/4]

QEventTransition::QEventTransition ( QEventTransitionPrivate dd,
QObject object,
QEvent::Type  type,
QState parent 
)
protected
Warning
This function is not part of the public interface.

Definition at line 175 of file qeventtransition.cpp.

177  : QAbstractTransition(dd, parent)
178 {
180  d->registered = false;
181  d->object = object;
182  d->eventType = type;
183 }
double d
Definition: qnumeric_p.h:62
int type
Definition: qmetatype.cpp:239
#define Q_D(Class)
Definition: qglobal.h:2482
The QEventTransition class provides a QObject-specific transition for Qt events.
QAbstractTransition(QState *sourceState=0)
Constructs a new QAbstractTransition object with the given sourceState.

Functions

◆ event()

bool QEventTransition::event ( QEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractTransition.

Definition at line 262 of file qeventtransition.cpp.

Referenced by eventTest(), QKeyEventTransition::eventTest(), and QMouseEventTransition::eventTest().

263 {
264  return QAbstractTransition::event(e);
265 }
bool event(QEvent *e)
Reimplemented Function

◆ eventSource()

QObject* QEventTransition::eventSource ( ) const

Referenced by setEventType().

◆ eventTest()

bool QEventTransition::eventTest ( QEvent event)
protectedvirtual

Reimplemented Function

Implements QAbstractTransition.

Reimplemented in QMouseEventTransition, and QKeyEventTransition.

Definition at line 240 of file qeventtransition.cpp.

Referenced by QKeyEventTransition::eventTest(), and QMouseEventTransition::eventTest().

241 {
242  Q_D(const QEventTransition);
243  if (event->type() == QEvent::StateMachineWrapped) {
245  return (we->object() == d->object)
246  && (we->event()->type() == d->eventType);
247  }
248  return false;
249 }
double d
Definition: qnumeric_p.h:62
The WrappedEvent class inherits QEvent and holds a clone of an event associated with a QObject...
Definition: qstatemachine.h:92
#define Q_D(Class)
Definition: qglobal.h:2482
QObject * object() const
Returns the object that the event is associated with.
Definition: qstatemachine.h:98
bool event(QEvent *e)
Reimplemented Function
The QEventTransition class provides a QObject-specific transition for Qt events.
Type type() const
Returns the event type.
Definition: qcoreevent.h:303
QEvent * event() const
Returns a clone of the original event.
Definition: qstatemachine.h:99

◆ eventType()

QEvent::Type QEventTransition::eventType ( ) const

Referenced by ~QEventTransition().

◆ onTransition()

void QEventTransition::onTransition ( QEvent event)
protectedvirtual

Reimplemented Function

Implements QAbstractTransition.

Reimplemented in QMouseEventTransition, and QKeyEventTransition.

Definition at line 254 of file qeventtransition.cpp.

Referenced by QKeyEventTransition::onTransition(), and QMouseEventTransition::onTransition().

255 {
256  Q_UNUSED(event);
257 }
#define Q_UNUSED(x)
Indicates to the compiler that the parameter with the specified name is not used in the body of a fun...
Definition: qglobal.h:1729

◆ setEventSource()

void QEventTransition::setEventSource ( QObject object)

Sets the event source associated with this event transition to be the given object.

Definition at line 227 of file qeventtransition.cpp.

228 {
230  if (d->object == object)
231  return;
232  d->unregister();
233  d->object = object;
234  d->maybeRegister();
235 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QEventTransition class provides a QObject-specific transition for Qt events.

◆ setEventType()

void QEventTransition::setEventType ( QEvent::Type  type)

Sets the event type that this event transition is associated with.

Definition at line 204 of file qeventtransition.cpp.

205 {
207  if (d->eventType == type)
208  return;
209  d->unregister();
210  d->eventType = type;
211  d->maybeRegister();
212 }
double d
Definition: qnumeric_p.h:62
int type
Definition: qmetatype.cpp:239
#define Q_D(Class)
Definition: qglobal.h:2482
The QEventTransition class provides a QObject-specific transition for Qt events.

Properties

◆ eventSource

QObject * QEventTransition::eventSource
private

the event source that this event transition is associated with

Returns the event source associated with this event transition.

Definition at line 60 of file qeventtransition.h.

◆ eventType

QEvent::Type QEventTransition::eventType
private

the type of event that this event transition is associated with

Returns the event type that this event transition is associated with.

Definition at line 61 of file qeventtransition.h.

Referenced by QStateMachinePrivate::registerEventTransition(), and QStateMachinePrivate::unregisterEventTransition().


The documentation for this class was generated from the following files: