Compartilhar via


VisualState.Storyboard Propriedade

Definição

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

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 (um Grid) de verde para vermelho quando o usuário coloca o ponteiro sobre o Button. O VisualState com o valor do atributo x:Name de "Normal" é incluído para que, quando o usuário mover o ponteiro para fora do botão, a Grid tela de fundo 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 é null ou um único Storyboard objeto. 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 ter como destino 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 exista 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.

Aplica-se a

Confira também