Share via


PropertyAnimation Class

Definition

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

public ref class PropertyAnimation sealed : IPropertyAnimation
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Core.AnimationMetrics.AnimationMetricsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PropertyAnimation final : IPropertyAnimation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Core.AnimationMetrics.AnimationMetricsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PropertyAnimation : IPropertyAnimation
Public NotInheritable Class PropertyAnimation
Implements IPropertyAnimation
Inheritance
Object Platform::Object IInspectable PropertyAnimation
Attributes
Implements

Windows requirements

Device family
Windows Desktop Extension SDK (introduced in 10.0.10240.0)
API contract
Windows.UI.Core.AnimationMetrics.AnimationMetricsContract (introduced in v1.0)

Remarks

Obtain instances of this object through the AnimationDescription.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

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.

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.

Delay

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

Duration

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

Type

Gets the type of animation represented by this object.

Applies to

See also