VisualTransition.Storyboard Property

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Gets or sets the Storyboard that occurs when the transition occurs.

public:
 property System::Windows::Media::Animation::Storyboard ^ Storyboard { System::Windows::Media::Animation::Storyboard ^ get(); void set(System::Windows::Media::Animation::Storyboard ^ value); };

public System.Windows.Media.Animation.Storyboard Storyboard { get; set; }

member this.Storyboard : System.Windows.Media.Animation.Storyboard with get, set

Public Property Storyboard As Storyboard

Property Value

Storyboard

The Storyboard that occurs when the transition occurs.

Examples

The following example creates a VisualTransition that specifies that when the user moves the mouse away from the control, the control's border changes to blue, then to yellow, and then to black in 1.5 seconds. For the entire example, see Customizing the Appearance of an Existing Control by Creating a ControlTemplate.

<!--Take one and a half seconds to transition from the
    MouseOver state to the Normal state. 
    Have the SolidColorBrush, BorderBrush, fade to blue, 
    then to yellow, and then to black in that time.-->
<VisualTransition From="MouseOver" To="Normal" 
                      GeneratedDuration="0:0:1.5">
  <Storyboard>
    <ColorAnimationUsingKeyFrames
      Storyboard.TargetProperty="Color"
      Storyboard.TargetName="BorderBrush"
      FillBehavior="HoldEnd" >

      <ColorAnimationUsingKeyFrames.KeyFrames>

        <LinearColorKeyFrame Value="Blue" 
          KeyTime="0:0:0.5" />
        <LinearColorKeyFrame Value="Yellow" 
          KeyTime="0:0:1" />
        <LinearColorKeyFrame Value="Black" 
          KeyTime="0:0:1.5" />

      </ColorAnimationUsingKeyFrames.KeyFrames>
    </ColorAnimationUsingKeyFrames>
  </Storyboard>
</VisualTransition>

Remarks

When a VisualTransition contains a Storyboard, the Storyboard runs any time the VisualTransition is applied. For example, if you want the border of a Button to change colors when the user moves the mouse away from it, you can create a VisualTransition that has a Storyboard that changes the button's background.