IPropertyAnimation IPropertyAnimation IPropertyAnimation IPropertyAnimation IPropertyAnimation Interface


Describes properties of animations that are common to all animation effects.

public : interface IPropertyAnimation
struct winrt::Windows::UI::Core::AnimationMetrics::IPropertyAnimation
public interface IPropertyAnimation
Public Interface IPropertyAnimation
// You can't instantiate an interface directly in JavaScript. You can use objects that implement the interface, however.
Windows 10 requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0)
API contract
Windows.UI.Core.AnimationMetrics.AnimationMetricsContract (introduced v1)


Do not implement this interface. Obtain a pointer to an instance of this interface by using the AnimationDescription.Animations property.

The timing controls Control1 and Control2 specify the location of the first and second control points of a cubic Bézier curve. These two points have the same meaning as they do in the CSS transition-timing-function property. Control point zero is always (0,0) and control point three is always (1,1). The coordinates of Control1 and Control2 are always in the range 0 to 1, inclusive.

On the resulting Bézier curve, the x-coordinate represents time and the y-coordinate represents progress. The raw curve from (0,0) to (1,1) is scaled to match the actual duration and range of the animated transition, such that x=0 is the starting time of the transform, x=1 is the ending time, y=0 is the initial value of the animated property, and y=1 is the final value. Values of x and y between 0 and 1 represent corresponding intermediate values of time and the animation.


Control1 Control1 Control1 Control1 Control1

Gets the location of the first control point for the cubic Bézier curve that describes how this property of this object should animate over time.

public : Point Control1 { get; }
Point Control1();
public Point Control1 { get; }
Public ReadOnly Property Control1 As Point
var point = iPropertyAnimation.control1;
Point Point Point

The location of the control point.

See Also

Control2 Control2 Control2 Control2 Control2

Gets the location of the second control point for the cubic Bézier curve that describes how this property of this object should animate over time.

public : Point Control2 { get; }
Point Control2();
public Point Control2 { get; }
Public ReadOnly Property Control2 As Point
var point = iPropertyAnimation.control2;
Point Point Point

The location of the control point.

See Also

Delay Delay Delay Delay Delay

Gets the amount of time between when the animation is instructed to begin and when that animation actually begins to draw.

public : TimeSpan Delay { get; }
TimeSpan Delay();
public TimeSpan Delay { get; }
Public ReadOnly Property Delay As TimeSpan
var timeSpan = iPropertyAnimation.delay;
TimeSpan TimeSpan TimeSpan

The amount of time to delay before starting an animation.


This delay is in addition to any StaggerDelay applied to the parent AnimationDescription. For instance, if a transition is scheduled through the application of StaggerDelay and StaggerDelayFactor to begin at time t=200 ms and this delay is set to 250 ms, then the transition will actually begin to animate at 450 ms.

See Also

Duration Duration Duration Duration Duration

Gets the amount of time over which the animation should be performed. This does not include the delay.

public : TimeSpan Duration { get; }
TimeSpan Duration();
public TimeSpan Duration { get; }
Public ReadOnly Property Duration As TimeSpan
var timeSpan = iPropertyAnimation.duration;
TimeSpan TimeSpan TimeSpan

The duration of the animation.


The duration can be 0, in which case all animated properties are instantly set to their final values and no animation is shown.

See Also

Type Type Type Type Type

Gets the type of animation represented by this object.

public : PropertyAnimationType Type { get; }
PropertyAnimationType Type();
public PropertyAnimationType Type { get; }
Public ReadOnly Property Type As PropertyAnimationType
var propertyAnimationType = iPropertyAnimation.type;
PropertyAnimationType PropertyAnimationType PropertyAnimationType

One of the animation type values.


The IPropertyAnimation object can be cast to the derived object described by its type. See PropertyAnimationType for a list of types and their corresponding objects.

See Also

See Also