ContentElement.BeginAnimation Method (DependencyProperty, AnimationTimeline, HandoffBehavior)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

Namespace:   System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

public void BeginAnimation(
	DependencyProperty dp,
	AnimationTimeline animation,
	HandoffBehavior handoffBehavior
)

Parameters

dp
Type: System.Windows.DependencyProperty

The property to animate, which is specified as the dependency property identifier.

animation
Type: System.Windows.Media.Animation.AnimationTimeline

The timeline of the animation to be applied.

handoffBehavior
Type: System.Windows.Media.Animation.HandoffBehavior

A value of the enumeration that specifies how the new animation interacts with any current (running) animations that are already affecting the property value.

When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. However, the originally associated animation timeline is not stopped. Any other animations assigned to that timeline will continue to run.

.NET Framework
Available since 3.0
Return to top
Show: