AnimationTimeline Class
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace: http://schemas.microsoft.com/winfx/2006/xaml/presentation
An AnimationTimeline is a type of Timeline object that generates output values based on its timing progress. All animation types inherit from AnimationTimeline.
Freezable Features: Because it inherits from the Freezable class, the AnimationTimeline class provides several special features: AnimationTimeline objects can be declared as resources, shared among multiple objects, made read-only to improve performance, cloned, and made thread-safe. For more information about the different features provided by Freezable objects, see the Freezable Objects Overview.
Notes to Inheritors: To create a custom animation, override or implement the following members:-
CreateInstanceCore – If your new class is concrete, you must override CreateInstanceCore to return a new instance of your class.
-
GetCurrentValue – Override this method to return the current value of your animation. It takes three parameters: a default origin value, a default destination value, and an AnimationClock. Use the AnimationClock to obtain the current time or progress for the animation. You can choose whether to use the default origin and destination values.
-
IsDestinationDefault – Override this property to indicate whether your animation uses the default destination value specified by the GetCurrentValue method.
-
TargetPropertyType – Override this property to indicate the Type of output your animation produces.
This example shows one way to apply an animation to a property without using a Storyboard.
Note: |
|---|
| This functionality is not available in Extensible Application Markup Language (XAML). For information about animating a property in XAML, see How to: Animate a Property by Using a Storyboard. |
To apply a local animation to a property, use the BeginAnimation method. This method takes two parameters: a DependencyProperty that specifies the property to animate, and the animation to apply to that property.
The following example shows how to animate the width and background color of a Button.
/* This sample demonstrates how to apply non-storyboard animations to a property. To animate in markup, you must use storyboards. */ using System; using System.Windows; using System.Windows.Navigation; using System.Windows.Media; using System.Windows.Media.Animation; using System.Windows.Shapes; using System.Windows.Controls; namespace Microsoft.Samples.Animation.LocalAnimations { // Create the demonstration. public class LocalAnimationExample : Page { public LocalAnimationExample() { WindowTitle = "Local Animation Example"; StackPanel myStackPanel = new StackPanel(); myStackPanel.Margin = new Thickness(20); // Create and set the Button. Button aButton = new Button(); aButton.Content = "A Button"; // Animate the Button's Width. DoubleAnimation myDoubleAnimation = new DoubleAnimation(); myDoubleAnimation.From = 75; myDoubleAnimation.To = 300; myDoubleAnimation.Duration = new Duration(TimeSpan.FromSeconds(5)); myDoubleAnimation.AutoReverse = true; myDoubleAnimation.RepeatBehavior = RepeatBehavior.Forever; // Apply the animation to the button's Width property. aButton.BeginAnimation(Button.WidthProperty, myDoubleAnimation); // Create and animate a Brush to set the button's Background. SolidColorBrush myBrush = new SolidColorBrush(); myBrush.Color = Colors.Blue; ColorAnimation myColorAnimation = new ColorAnimation(); myColorAnimation.From = Colors.Blue; myColorAnimation.To = Colors.Red; myColorAnimation.Duration = new Duration(TimeSpan.FromMilliseconds(7000)); myColorAnimation.AutoReverse = true; myColorAnimation.RepeatBehavior = RepeatBehavior.Forever; // Apply the animation to the brush's Color property. myBrush.BeginAnimation(SolidColorBrush.ColorProperty, myColorAnimation); aButton.Background = myBrush; // Add the Button to the panel. myStackPanel.Children.Add(aButton); this.Content = myStackPanel; } } }
For the complete sample, see Local Animations Sample.
A variety of animation classes in the System.Windows.Media.Animation namespace exist for animating different types of properties. For more information about animating properties, see Animation Overview. For more information about dependency properties (the type of properties that are shown in these examples) and their features, see Properties Overview.
There are other ways to animate without using Storyboard objects; for more information, see the Property Animation Techniques Overview.
More Code
| How to: Animate a Property by Using a Storyboard | This example shows how to use a Storyboard to animate properties. To animate a property by using a Storyboard, create an animation for each property that you want to animate and also create a Storyboard to contain the animations. |
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Freezable
System.Windows.Media.Animation.Animatable
System.Windows.Media.Animation.Timeline
System.Windows.Media.Animation.AnimationTimeline
Derived Classes
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 Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.
Note: