Compartir a través de


VisualState.Storyboard Propiedad

Definición

Obtiene o establece un guión gráfico que define los valores de propiedad específicos del estado y la apariencia del control cuando usa este estado visual.

public:
 property Storyboard ^ Storyboard { Storyboard ^ get(); void set(Storyboard ^ value); };
Storyboard Storyboard();

void Storyboard(Storyboard value);
public Storyboard Storyboard { get; set; }
var storyboard = visualState.storyboard;
visualState.storyboard = storyboard;
Public Property Storyboard As Storyboard
<VisualState>
  singleStoryboard
</VisualState>

Valor de propiedad

Guión gráfico que define los cambios de propiedad que se aplicarán al control cuando se usa este objeto VisualState como estado visual actual.

Ejemplos

En este ejemplo se crea un controlTemplate simple para un botón que contiene una cuadrícula. VisualState con el valor del atributo x:Name de "PointerOver" tiene un Guión gráfico que cambia el color del contenido del botón (un Grid) de verde a rojo cuando el usuario coloca el puntero sobre .Button VisualState con el valor del atributo x:Name de "Normal" se incluye para que cuando el usuario mueva el puntero fuera del botón, el Grid fondo vuelve a verde.

<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to transition to the PointerOver state.-->
          <VisualTransition To="PointerOver" 
                              GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>
        
        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            Pointer is over the button.-->
        <VisualState x:Name="PointerOver">
          <Storyboard>
            <ColorAnimation Storyboard.TargetName="ButtonBrush" 
                            Storyboard.TargetProperty="Color" To="Red" />
          </Storyboard>
        </VisualState>
      </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Grid.Background>
      <SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
    </Grid.Background>
  </Grid>
</ControlTemplate>

Comentarios

El valor de la propiedad Storyboard es null o un único Storyboard objeto. Un Storyboard es como un contenedor para animaciones; puede contener una o varias definiciones de animación. Cada una de estas animaciones puede tener como destino una propiedad de dependencia específica en un destino con nombre específico. El destino con nombre debe ser un elemento de la plantilla de control que tiene un valor de atributo Name o x:Name definido en la propia plantilla. La propiedad de dependencia debe ser una propiedad que exista en el modelo de objetos de ese objeto o en una propiedad adjunta. Para establecer como destino las animaciones, use las propiedades adjuntas Storyboard.TargetName y Storyboard.TargetProperty . Para obtener más información sobre cómo definir animaciones con sintaxis XAML y los tipos de animaciones que puedes usar, consulta Animaciones con guion gráfico.

Las animaciones que afectan al diseño son animaciones potencialmente dependientes, lo que puede tener consecuencias de rendimiento para los usuarios del control cuando el control carga un Objeto VisualState.

Se aplica a

Consulte también