IXRColorAnimation (Windows Embedded CE 6.0)

1/6/2010

This class animates a color value between two target values by using linear interpolation over a specified duration, which is set by the inherited method IXRTimeline::SetDuration.

Syntax

class IXRColorAnimation : public IXRTimeline

Functions

Remarks

An animation updates the value of a property over a period of time. An animation effect can be subtle, such as moving an IXRShape object a few pixels left or right, or dramatic, such as enlarging an object to 200 times its original size while spinning it and changing its color. To create an animation, use the inherited IXRDependencyObject::SetAttachedProperty function to identify a target property to animate.

The IXRColorAnimation class creates a transition between two target values. To set its target values, use its SetFrom, SetTo, and SetBy functions. The following table summarizes how these functions can be used together or separately to determine the target values of an animation.

If you use both the SetTo and SetBy functions, the value specified in SetTo takes precedence and the SetBy property is ignored.

To use other interpolation methods or to define an animation that progresses through more than two target values use the IXRColorAnimationUsingKeyFrames object.

A collection of animation storyboards, including IXRColorAnimation objects, belongs to an IXRStoryboard object.

You can also define a color animation in Microsoft Silverlight 2. For information about the differences between XAML in Silverlight for Windows Embedded and Silverlight 2, see Differences Between Silverlight for the Web and Silverlight for Windows Embedded. For more information about how to define this element in the source XAML for your application, see this Microsoft Web site.

Description

The following code example defines new color values, sets the Fill property of a rectangle defined in source XAML as the animation target, and creates an animation storyboard that will animate the color of the interior of the rectangle at run-time.

Code

#include "XamlRuntime.h"

void CreateAnimationForStoryboard(IXRApplication* pApplication, IXRVisualRoot* pVisualRoot, IXRStoryboard* myStoryboard)
{
  // Create a new rectangle
  IXRRectangle* pRect;
  float rHeight = 100;
  float rWidth = 50;

  pApplication->CreateObject(IID_IXRRectangle, &pRect);
  pRect->SetWidth(&rWidth);
  pRect->SetHeight(&rHeight);
  pRect->SetName(L"NewRectangle");

  // Define some new solid color values
  COLORREF startBrushColor = RGB(0,50,100);
  COLORREF newBrushColor = RGB(0,50,0);

  // Now create an animation that will change the interior of the Rectangle 
  // to a new color when triggered

  XRTimeSpan ColoringTime = { 50000 };
  IXRColorAnimation* myColorAnimation;

  pApplication->CreateObject(IID_IXRColorAnimation, &myColorAnimation);
  myColorAnimation->SetAttachedProperty(L"Storyboard.TargetName", L"NewRectangle");
  myColorAnimation->SetAttachedProperty(L"Storyboard.TargetProperty", L"Fill");
  myColorAnimation->SetFrom(startBrushColor);
  myColorAnimation->SetTo(newBrushColor);
  myColorAnimation->SetBeginTime(ColoringTime);

  // Add myColorAnimation to a storyboard's collection of animations. 
  // When you call myStoryboard.Begin from within an event handler, 
  // its child animation, myColorAnimation, is triggered.

  IXRTimelineCollection* pChildrenAnimations;
  UINT* index;

  myStoryboard->GetChildren(&pChildrenAnimations);
  pChildrenAnimations->Add(&myColorAnimation, &index);
}

Comments

To run this code example, the IXRApplication instance must already be created, the visual tree must already be generated, the rectangle defined in XAML must be parsed into an IXRRectangle object, and an IXRStoryboard instance must already be created to represent an object that is stored in the visual tree.

Inheritance Hierarchy

IXRDependencyObject

    IXRTimeline

        IXRColorAnimation

.NET Framework Equivalent

System.Windows.Media.Animation.ColorAnimation

Requirements

See Also

Reference

Classes for Visual Appearance and Behavior
IXRStoryboard