VisualStateGroup Classe

Definição

public ref class VisualStateGroup : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("States")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualStateGroup : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("States")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualStateGroup = class
    inherit DependencyObject

Public Class VisualStateGroup
Inherits DependencyObject

Herança

Object

DispatcherObject

DependencyObject

VisualStateGroup

Atributos

ContentPropertyAttribute RuntimeNamePropertyAttribute

Exemplos

O exemplo a seguir cria um simples ControlTemplate para um Button que contém um Grid. Ele também contém um VisualStateGroup chamado CommonStates, que define os MouseOver estados e Normal . O VisualStateGroup também tem um VisualTransition que especifica que leva meio segundo para que o Grid mude de verde para vermelho quando o usuário move o ponteiro do mouse sobre o Button.

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

        <VisualStateGroup.Transitions>

          <!--Take one half second to trasition to the MouseOver state.-->
          <VisualTransition To="MouseOver" 
            GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>

        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            mouse is over the button.-->
        <VisualState x:Name="MouseOver">
          <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

Cada VisualStateGroup contém uma coleção de VisualState objetos . Um VisualState contém uma coleção de Storyboard objetos que especificam como a aparência do controle é alterada quando o controle está em um determinado estado. Por exemplo, um Button pode ter uma aparência um pouco diferente quando é pressionado do que quando não é pressionado. Dois estados que o Button define correspondem a quando é pressionado ("Pressed") e quando não é ("Normal").

VisualState Adicione a um controle definindo a VisualStateManager.VisualStateGroups propriedade anexada no controle . Você coloca estados mutuamente exclusivos uns dos outros no mesmo VisualStateGroup. Por exemplo, o CheckBox tem dois VisualStateGroup objetos . Um contém os estados, Normal, MouseOver, Pressede Disabled. O outro contém os estados, Checked, UnCheckede Indeterminate. O CheckBox pode estar em estados MouseOver e UnChecked ao mesmo tempo, mas não pode estar nos MouseOver estados e Pressed ao mesmo tempo.

Embora você possa adicionar VisualState objetos a qualquer elemento, eles são uma maneira particularmente útil de permitir que outras pessoas redefinam o comportamento visual de um Control. Se você criar um controle personalizado que usa um ControlTemplate, poderá especificar em quais estados esse controle pode estar adicionando um TemplateVisualStateAttribute em sua definição de classe. Em seguida, qualquer pessoa que cria um novo ControlTemplate para o controle pode adicionar VisualState objetos ao modelo. O TemplateVisualStateAttribute permite que ferramentas de designer, como o Visual Studio e o Blend for Visual Studio, exponham os estados do controle. Os estados com o mesmo TemplateVisualStateAttribute.GroupName pertencem ao mesmo VisualStateGroup.

Para obter mais informações sobre como usar VisualStateGroup objetos em um ControlTemplate, consulte Personalizando a aparência de um controle existente criando um ControlTemplate. Para obter mais informações sobre como criar controles que usam o VisualStateManager, consulte Criando um controle que tem uma aparência personalizável.

A Transitions propriedade contém VisualTransition objetos que são aplicados quando o controle faz a transição entre estados definidos no VisualStateGroup.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a