Qt Reference Documentation

# QSequentialAnimationGroup Class Reference

The QSequentialAnimationGroup class provides a sequential group of animations. More...

     #include <QSequentialAnimationGroup>

Inherits: QAnimationGroup.

This class was introduced in Qt 4.6.

- List of all members, including inherited members

## Properties

- currentAnimation : QAbstractAnimation * const

- 6 properties inherited from QAbstractAnimation
- 1 property inherited from QObject

## Public Functions

| QSequentialAnimationGroup ( QObject * parent = 0 )
| ~QSequentialAnimationGroup ()
QPauseAnimation * | addPause ( int msecs )
QAbstractAnimation * | currentAnimation () const
QPauseAnimation * | insertPause ( int index, int msecs )

## Reimplemented Public Functions

virtual int | duration () const

- 8 public functions inherited from QAnimationGroup
- 11 public functions inherited from QAbstractAnimation
- 29 public functions inherited from QObject

## Signals

void | currentAnimationChanged ( QAbstractAnimation * current )

- 4 signals inherited from QAbstractAnimation
- 1 signal inherited from QObject

## Reimplemented Protected Functions

virtual bool | event ( QEvent * event )
virtual void | updateCurrentTime ( int currentTime )
virtual void | updateDirection ( QAbstractAnimation::Direction direction )
virtual void | updateState ( QAbstractAnimation::State newState, QAbstractAnimation::State oldState )

- 1 protected function inherited from QAnimationGroup
- 4 protected functions inherited from QAbstractAnimation
- 8 protected functions inherited from QObject

### Additional Inherited Members

- 6 public slots inherited from QAbstractAnimation
- 1 public slot inherited from QObject
- 7 static public members inherited from QObject
- 1 protected function inherited from QAnimationGroup
- 4 protected functions inherited from QAbstractAnimation
- 8 protected functions inherited from QObject

## Detailed Description

The QSequentialAnimationGroup class provides a sequential group of animations.

QSequentialAnimationGroup is a QAnimationGroup that runs its animations in sequence, i.e., it starts one animation after another has finished playing. The animations are played in the order they are added to the group (using addAnimation() or insertAnimation()). The animation group finishes when its last animation has finished.

At each moment there is at most one animation that is active in the group; it is returned by currentAnimation(). An empty group has no current animation.

A sequential animation group can be treated as any other animation, i.e., it can be started, stopped, and added to other groups. You can also call addPause() or insertPause() to add a pause to a sequential animation group.

     QSequentialAnimationGroup *group = new QSequentialAnimationGroup;

     group->addAnimation(anim1);
     group->addAnimation(anim2);

     group->start();

In this example, `anim1` and `anim2` are two already set up QPropertyAnimations.

See also QAnimationGroup, QAbstractAnimation, and The Animation Framework.

## Property Documentation

### currentAnimation : QAbstractAnimation * const

Returns the animation in the current time.

Access functions:

QAbstractAnimation * | currentAnimation () const

Notifier signal:

void | currentAnimationChanged ( QAbstractAnimation * current )

See also currentAnimationChanged().

## Member Function Documentation

### QSequentialAnimationGroup::QSequentialAnimationGroup ( QObject * parent = 0 )

Constructs a QSequentialAnimationGroup. parent is passed to QObject's constructor.

### QSequentialAnimationGroup::~QSequentialAnimationGroup ()

Destroys the animation group. It will also destroy all its animations.

### QPauseAnimation * QSequentialAnimationGroup::addPause ( int msecs )

Adds a pause of msecs to this animation group. The pause is considered as a special type of animation, thus animationCount will be increased by one.

See also insertPause() and QAnimationGroup::addAnimation().

### void QSequentialAnimationGroup::currentAnimationChanged ( QAbstractAnimation * current )`[signal]`

QSequentialAnimationGroup emits this signal when currentAnimation has been changed. current is the current animation.

See also currentAnimation().

### int QSequentialAnimationGroup::duration () const`[virtual]`

Reimplemented from QAbstractAnimation::duration().

### bool QSequentialAnimationGroup::event ( QEvent * event )`[virtual protected]`

Reimplemented from QObject::event().

### QPauseAnimation * QSequentialAnimationGroup::insertPause ( int index, int msecs )

Inserts a pause of msecs milliseconds at index in this animation group.

See also addPause() and QAnimationGroup::insertAnimation().

### void QSequentialAnimationGroup::updateCurrentTime ( int currentTime )`[virtual protected]`

Reimplemented from QAbstractAnimation::updateCurrentTime().

### void QSequentialAnimationGroup::updateDirection ( QAbstractAnimation::Direction direction )`[virtual protected]`

Reimplemented from QAbstractAnimation::updateDirection().

### void QSequentialAnimationGroup::updateState ( QAbstractAnimation::State newState, QAbstractAnimation::State oldState )`[virtual protected]`

Reimplemented from QAbstractAnimation::updateState().