VisualTransition.Storyboard Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Property Storyboard As Storyboard
public Storyboard Storyboard { get; set; }
<object>
  singleStoryboard
</object>

XAML Values

  • singleStoryboard
    Exactly one Storyboard object element.

Storyboard is the XAML content property of VisualTransition and can thus support this content element syntax, as opposed to having to specify object.StoryBoard as a property element.

Property Value

Type: System.Windows.Media.Animation.Storyboard
The Storyboard that occurs when the transition occurs.

Remarks

When a VisualTransition contains a Storyboard, the Storyboard runs anytime 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.

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, then to black in 1.5 seconds. For the entire example, see Customizing the Appearance of an Existing Control by Using 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>

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.