Qt 4.8: QML AnchorAnimation Element

Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QML AnchorAnimation Element

The AnchorAnimation element animates changes in anchor values. More...

Inherits Animation

This element was introduced in Qt 4.7.

- List of all members, including inherited members

## Properties

- duration : int
- easing.amplitude : real
- easing.overshoot : real
- easing.period : real
- easing.type : enumeration
- targets : list<Item>

## Detailed Description

AnchorAnimation is used to animate an anchor change.

In the following snippet we animate the addition of a right anchor to a Rectangle:

     import QtQuick 1.0

     Item {
         id: container
         width: 200; height: 200

         Rectangle {
             id: myRect
             width: 100; height: 100
             color: "red"
         }

         states: State {
             name: "reanchored"
             AnchorChanges { target: myRect; anchors.right: container.right }
         }

         transitions: Transition {
             // smoothly reanchor myRect and move into new position
             AnchorAnimation { duration: 1000 }
         }

         Component.onCompleted: container.state = "reanchored"
     }

For convenience, when an AnchorAnimation is used in a Transition, it will animate any AnchorChanges that have occurred during the state change. This can be overridden by setting a specific target item using the target property.

Like any other animation element, an AnchorAnimation 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.

See also QML Animation and Transitions and AnchorChanges.

## Property Documentation

duration : int

This property holds the duration of the animation, in milliseconds.

The default value is 250.

easing.type : enumeration
easing.amplitude : real
easing.overshoot : real
easing.period : real

To specify an easing curve you need to specify at least the type. For some curves you can also specify amplitude, period and/or overshoot. The default easing curve is Linear.

     AnchorAnimation { easing.type: Easing.InOutQuad }

See the PropertyAnimation::easing.type documentation for information about the different types of easing curves.

read-onlytargets : list<Item>

The items to reanchor.

If no targets are specified all AnchorChanges will be animated by the AnchorAnimation.