MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QML SequentialAnimation Element

The SequentialAnimation element allows animations to be run sequentially. More...

Inherits Animation

This element was introduced in Qt 4.7.

Detailed Description

The SequentialAnimation and ParallelAnimation elements allow multiple animations to be run together. Animations defined in a SequentialAnimation are run one after the other, while animations defined in a ParallelAnimation are run at the same time.

The following example runs two number animations in a sequence. The Rectangle animates to a x position of 50, then to a y position of 50.

 import QtQuick 1.0

 Rectangle {
     id: rect
     width: 100; height: 100
     color: "red"

     SequentialAnimation {
         running: true
         NumberAnimation { target: rect; property: "x"; to: 50; duration: 1000 }
         NumberAnimation { target: rect; property: "y"; to: 50; duration: 1000 }
     }
 }

Animations defined within a Transition are automatically run in parallel, so SequentialAnimation can be used to enclose the animations in a Transition if this is the preferred behavior.

Like any other animation element, a SequentialAnimation can be applied in a number of ways, including transitions, behaviors and property value sources. The QML Animation and Transitions documentation shows a variety of methods for creating animations.

Note: Once an animation has been grouped into a SequentialAnimation or ParallelAnimation, it cannot be individually started and stopped; the SequentialAnimation or ParallelAnimation must be started and stopped as a group.

See also ParallelAnimation, QML Animation and Transitions, and Animation basics example.