VisualStateGroup Classe

Definição

Namespace:

Windows.UI.Xaml

Contém objetos VisualState mutuamente exclusivos e objetos VisualTransition que são usados para ir de um estado para outro.

public ref class VisualStateGroup sealed : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="States")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class VisualStateGroup final : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="States")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class VisualStateGroup : DependencyObject

Public NotInheritable Class VisualStateGroup
Inherits DependencyObject

<VisualStateManager.VisualStateGroups>
   <VisualStateGroup x:Name="groupname" ...>
     oneOrMoreVisualStates
   </VisualStateGroup>
   <!--- other peer VisualStateGroup's here ... -->
</VisualStateManager.VisualStateGroups>

Herança

Object Platform::Object IInspectable DependencyObject VisualStateGroup

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo cria um ControlTemplate simples para um Botão que contém uma Grade. Ele também contém um VisualStateGroup chamado "CommonStates", que define os estados "PointerOver" e "Normal". O VisualStateGroup também tem um VisualTransition que especifica que leva meio segundo para que a Grade mude de verde para vermelho quando o usuário coloca o ponteiro sobre o Botão.

<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

Cada VisualStateGroup declarado em XAML como parte de um modelo de controle deve sempre ter um atributo x:Name definido nele. Cada cadeia de caracteres de nome usada no conjunto de VisualStateGroups em um modelo de controle deve ser exclusiva nesse modelo. No entanto, é comum usar os mesmos nomes de grupo para controles diferentes. Por exemplo, quase todos os modelos de controle existentes têm um VisualStateGroup com atributo x:Name de "CommonStates".

O conjunto de estados visuais em cada VisualStateGroup deve ser mutuamente exclusivo no grupo. Em outras palavras, o controle deve usar exatamente um dos estados visuais de cada um de seus grupos do VisualStateGroup definidos o tempo todo. Sempre que houver um caso em que um controle se destine a estar simultaneamente em dois estados, verifique se os dois estados estão em grupos diferentes. Por exemplo, é possível que um controle suspenso seja focado simultaneamente e tenha sua lista suspensa aberta. Em um design de estado visual correto, você teria um VisualStateGroup separado para cada estado para que ambos possam estar ativos ao mesmo tempo. Esses grupos podem ter nomes como "FocusStates" e "DropDownStates".

Sempre que você definir um VisualStateGroup que habilita um comportamento storyboard temporário em um de seus elementos VisualState , verifique se o grupo também contém um segundo VisualState que pode ser chamado para cancelar o estado anterior. Isso pode ser tão simples quanto declarar o segundo VisualState sem nenhum Storyboard , apenas um atributo x:Name.

O valor do atributo x:Name definido para um VisualStateGroup não é usado para uma chamada para VisualStateManager.GoToState; em vez disso, é o atributo x:Name de um VisualState que é usado para VisualStateManager.GoToState. Qualquer pessoa que use VisualStateManager.GoToState deve estar ciente de todos os grupos e estados disponíveis, de modo que cada chamada faça a transição correta de estados antigos para novos estados dentro de um grupo.

Além de um conjunto de elementos VisualState , um VisualStateGroup também pode definir um conjunto de elementos VisualTransition , em que cada VisualTransition pertence a pelo menos um dos elementos nomeados do VisualState definidos no grupo. Em XAML, o conjunto de elementos VisualState pode ser declarado como elemento filho do elemento de objeto imediato do VisualStateGroup. Isso é possível porque a propriedade States , que é a coleção de estados visuais, é a propriedade de conteúdo XAML para VisualStateGroup. Por outro lado, para definir a coleção de transições visuais, você deve declarar essa coleção dentro de um elemento de propriedade VisualStateGroup.Transitions em XAML. Para obter mais informações sobre propriedades de conteúdo XAML, consulte Guia de sintaxe XAML.

Ao usar StateTriggers para controlar estados visuais, o mecanismo de gatilho usa as seguintes regras de precedência para pontuar gatilhos e determinar qual gatilho e o VisualState correspondente estarão ativos:

1. Gatilho personalizado que deriva de StateTriggerBase
2. AdaptiveTrigger ativado devido a MinWindowWidth
3. AdaptiveTrigger ativado devido a MinWindowHeight

Se houver vários gatilhos ativos por vez que tenham um conflito na pontuação (ou seja, dois gatilhos personalizados ativos), o primeiro declarado no arquivo de marcação terá precedência.

Observação: embora AdaptiveTrigger deriva de StateTriggerBase, ele só pode ser ativado por meio da configuração de MinWindowWidth e/ou MinWindowHeight.

Visualstategroup API que dá suporte à implementação personalizada do VisualStateManager

Muitos da API do VisualStateGroup existem apenas para dar suporte à implementação personalizada do VisualStateManager . Estes incluem: Name, CurrentState, CurrentStateChanging, CurrentStateChanged. Os usos mais comuns de estados visuais para modelos de controle não precisarão dessas API. Em particular, não é comum lidar com os eventos. A maioria das operações lógicas para um controle deve envolver suas próprias propriedades e eventos. Para a maioria dos cenários de definição de aplicativo e controle, as alterações de estado visual que ocorrem no controle devem ser apenas um resultado final da lógica que o controle aplica ao modelo, não um gatilho para outra lógica.

Construtores

VisualStateGroup()

Inicializa uma nova instância da classe VisualStateGroup .

Propriedades

CurrentState	Obtém o VisualState mais recentemente definido de uma chamada bem-sucedida para o método GoToState .
Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
Name	Obtém o nome do VisualStateGroup.
States	Obtém a coleção de objetos VisualState mutuamente exclusivos.
Transitions	Obtém a coleção de objetos VisualTransition .

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Eventos

CurrentStateChanged	Ocorre depois que um controle é alterado para um estado diferente.
CurrentStateChanging	Ocorre quando um controle começa a mudar para um estado diferente.

Confira também

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