UIElement.Transitions Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

Obtém ou define a coleção de elementos de estilo de transição que se aplicam a um UIElement.

public:
 property TransitionCollection ^ Transitions { TransitionCollection ^ get(); void set(TransitionCollection ^ value); };

TransitionCollection Transitions();

void Transitions(TransitionCollection value);

public TransitionCollection Transitions { get; set; }

var transitionCollection = uIElement.transitions;
uIElement.transitions = transitionCollection;

Public Property Transitions As TransitionCollection

<uielement>
  <uielement.Transitions>
    <TransitionCollection>
      oneOrMoreTransitions
    </TransitionCollection>
  </uielement.Transitions>
</uielement>

Valor da propriedade

TransitionCollection

A coleção fortemente tipada de elementos de estilo De transição que se aplicam a um UIElement.

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Movimento.

Abra o aplicativo Galeria do WinUI 3 e veja as transições em ação.

O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou o código-fonte no GitHub.

O exemplo XAML a seguir mostra um único EntranceThemeTransition , conforme definido em um Style for a Button. As propriedades de animação de transição normalmente são definidas em estilos e modelos, em vez de como propriedades diretamente em uma definição de interface do usuário. Os estilos normalmente são armazenados como um recurso XAML.

<Grid Background="{StaticResource ApplicationPageBackgroundBrush}">
    <Grid.Resources>
        <Style x:Key="DefaultButtonStyle" TargetType="Button">
            <Setter Property="Transitions">
                <Setter.Value>
                    <TransitionCollection>
                        <EntranceThemeTransition/>
                    </TransitionCollection>
                </Setter.Value>
            </Setter>
        </Style>
    </Grid.Resources>

    <Button Style="{StaticResource DefaultButtonStyle}" 
            Content="EntranceThemeTransition style applied" />

</Grid>

Comentários

Observação

Antes de Windows 10, versão 1809 (SDK 17763), a sintaxe XAML para propriedades que têm um valor TransitionCollection requer que você declare um elemento de objeto TransitionCollection explícito como o valor e forneça elementos de objeto como elementos filho de TransitionCollection para cada uma das animações de transição que você deseja usar. No Windows 10, versão 1809 (SDK 17763) ou posterior, TransitionCollection dá suporte ao uso implícito da coleção, para que você possa omitir o elemento de objeto da coleção. Para obter mais informações sobre coleções implícitas e XAML, consulte Guia de sintaxe XAML.

Esta é uma lista curta de alguns dos tipos possíveis para transições:

• AddDeleteThemeTransition
• ContentThemeTransition
• EdgeUIThemeTransition
• EntranceThemeTransition
• PopupThemeTransition
• ReorderThemeTransition
• RepositionThemeTransition

Classes específicas que derivam de UIElement às vezes têm suas próprias propriedades que contêm outros tipos de transições para cenários específicos de classe. Por exemplo, Popup.ChildTransitions e ItemsControl.ItemContainerTransitions.

As animações de transição desempenham uma função específica no design da interface do usuário do seu aplicativo. A ideia básica é que, quando há uma alteração ou transição, a animação chama a atenção do usuário para a alteração.

Não é comum definir o valor da Transitions propriedade diretamente em um UIElement que é um elemento direto da interface do usuário do aplicativo. É mais comum que uma coleção de transições faça parte de um estado visual, modelo ou estilo. Nesse caso, você usa mecanismos como Setter de um Style para especificar a Transitions propriedade e define o valor usando conteúdo definido por XAML que normalmente é armazenado como um recurso XAML.

O VisualTransition não é um dos tipos que você coloca na UIElement.Transitions coleção. VisualTransition é especificamente para animações em grupos de estado visual e é usado pela propriedade VisualStateGroup.Transitions .

Confira também

• TransitionCollection
• Animações com storyboard