VisualState.Storyboard Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 (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.