VisualState.Storyboard Propriedade

Definição

Namespace:

Windows.UI.Xaml

Obtém ou define um Storyboard que define valores de propriedade específicos do estado e a aparência do controle quando ele está usando esse 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 da propriedade

Storyboard

Um Storyboard que define as alterações de propriedade a serem aplicadas ao controle quando este VisualState é usado como o estado visual atual.

Exemplos

Este exemplo cria um ControlTemplate simples para um Botão que contém uma Grade. O VisualState com o valor do atributo x:Name de "PointerOver" tem um Storyboard que altera a cor do conteúdo do botão (uma Grade) de verde para vermelho quando o usuário coloca o ponteiro sobre o Botão. O VisualState com o valor do atributo x:Name de "Normal" é incluído para que, quando o usuário move o ponteiro para fora do botão, o plano de fundo da grade retorne para 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>

Comentários

O valor da propriedade Storyboard é nulo ou um único objeto Storyboard . Um Storyboard é como um contêiner para animações; ele pode conter uma ou mais definições de animação. Cada animação desse tipo pode direcionar uma propriedade de dependência específica em um destino nomeado específico. O destino nomeado deve ser um elemento no modelo de controle que tenha um valor de atributo Name ou x:Name definido no próprio modelo. A propriedade de dependência deve ser uma propriedade que existe no modelo de objeto desse objeto ou uma propriedade anexada. Para direcionar animações, use as propriedades anexadas Storyboard.TargetName e Storyboard.TargetProperty . Para obter mais informações sobre como definir animações com sintaxe XAML e os tipos de animações que você pode usar, consulte Animações com storyboard.

Animações que afetam o layout são animações potencialmente dependentes, o que pode ter consequências de desempenho para os usuários do controle quando o controle carrega um VisualState. Para obter mais informações, consulte Animações de storyboard para estados visuais.

Confira também

• Storyboard
• Animações com storyboard
• Animações de storyboard para estados visuais
• Início rápido: modelos de controle
• Exemplo de estilo de aplicativo e controle XAML