UIElement.BeginAnimation Method (DependencyProperty, AnimationTimeline, HandoffBehavior)
Assembly: PresentationCore (in presentationcore.dll)
public void BeginAnimation ( DependencyProperty dp, AnimationTimeline animation, HandoffBehavior handoffBehavior )
public final void BeginAnimation ( DependencyProperty dp, AnimationTimeline animation, HandoffBehavior handoffBehavior )
public final function BeginAnimation ( dp : DependencyProperty, animation : AnimationTimeline, handoffBehavior : HandoffBehavior )
The property to animate, which is specified as the dependency property identifier.
The timeline of the animation to be applied.
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 a null reference (Nothing in Visual Basic), then any current animations are removed and the current value of the property is held.
If the entire animation value is a null reference (Nothing in Visual Basic), 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.
The following example implements a handler that obtains an existing animation from a resource and then calls BeginAnimation with a specified handoff behavior.
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter EditionThe Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.