PropertyAnimation PropertyAnimation PropertyAnimation PropertyAnimation Class

Provides methods that enable you to retrieve animation property values that are common to all PropertyAnimationType.

Syntax

Declaration

public sealed class PropertyAnimationpublic sealed class PropertyAnimationPublic NotInheritable Class PropertyAnimationpublic sealed class PropertyAnimation

Remarks

Obtain instances of this object through the Animations property.

When a property animation is playing, that animation can be replaced by a different animation before the first animation is finished. The second animation can start from the same point at which the first animation leaves off. There is a slight delay between the time that the second animation is instructed to begin and when it does. In Windows 8, this can lead to a visible jump in the animation because the first animation has progressed slightly further during that delay. Starting in Windows 8.1, the starting point of the second animation is recalculated at the time it begins so no jump is seen.

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.

Properties summary

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.

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.

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

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

Gets the type of animation represented by this object.

Properties

  • 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; }public Point Control1 { get; }Public ReadOnly Property Control1 As Pointpublic Point Control1 { get; }

    Property Value

  • 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; }public Point Control2 { get; }Public ReadOnly Property Control2 As Pointpublic Point Control2 { get; }

    Property Value

  • 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; }public TimeSpan Delay { get; }Public ReadOnly Property Delay As TimeSpanpublic TimeSpan Delay { get; }

    Property Value

    Remarks

    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.

  • 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; }public TimeSpan Duration { get; }Public ReadOnly Property Duration As TimeSpanpublic TimeSpan Duration { get; }

    Property Value

    Remarks

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

  • Type
    Type
    Type
    Type

    Gets the type of animation represented by this object.

    public PropertyAnimationType Type { get; }public PropertyAnimationType Type { get; }Public ReadOnly Property Type As PropertyAnimationTypepublic PropertyAnimationType Type { get; }

    Property Value

    Remarks

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

Device family

Windows Desktop Extension SDK (introduced v10.0.10240.0)

API contract

Windows.UI.Core.AnimationMetrics.AnimationMetricsContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.DualApiPartitionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute

Details

Assembly

Windows.UI.Core.AnimationMetrics.dll