Qt Reference Documentation

QML ColorAnimation Element

The ColorAnimation element animates changes in color values. More...

Inherits PropertyAnimation

  • List of all members, including inherited members
  • Properties

    Detailed Description

    ColorAnimation is a specialized PropertyAnimation that defines an animation to be applied when a color value changes.

    Here is a ColorAnimation applied to the color property of a Rectangle as a property value source. It animates the color property's value from its current value to a value of "red", over 1000 milliseconds:

     import QtQuick 1.0
    
     Rectangle {
         width: 100; height: 100
         color: "red"
    
         ColorAnimation on color { to: "yellow"; duration: 1000 }
     }

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

    For convenience, when a ColorAnimation is used in a Transition, it will animate any color properties that have been modified during the state change. If a property or properties are explicitly set for the animation, then those are used instead.

    See also QML Animation and Animation basics example.

    Property Documentation

    from : color

    This property holds the color value at which the animation should begin.

    For example, the following animation is not applied until a color value has reached "#c0c0c0":

     Item {
         states: [ ... ]
    
         transition: Transition {
             NumberAnimation { from: "#c0c0c0"; duration: 2000 }
         }
     }

    If the ColorAnimation is defined within a Transition or Behavior, this value defaults to the value defined in the starting state of the Transition, or the current value of the property at the moment the Behavior is triggered.

    See also QML Animation.


    to : color

    This property holds the color value at which the animation should end.

    If the ColorAnimation is defined within a Transition or Behavior, this value defaults to the value defined in the end state of the Transition, or the value of the property change that triggered the Behavior.

    See also QML Animation.


    X

    Thank you for giving your feedback.

    Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.