Compartilhar via

UIElement.Transitions Propriedade

  • Referência

Definição

Namespace:
Windows.UI.Xaml
Editar

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 transition que se aplicam a um UIElement.

Exemplos

Dica

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

Se você tiver o aplicativo WinUI 2 Gallery instalado, clique aqui para abrir o aplicativo e ver Transições Implícitas e Transições de Tema em ação.

Este exemplo XAML mostra uma única EntryThemeTransition conforme definido em um Estilo para um Botão. 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 exige 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. Em 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 pequena lista de alguns dos tipos possíveis para transições:

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 da classe. Por exemplo, Popup.ChildTransitions e ItemsControl.ItemContainerTransitions.

As animações de transição desempenham um papel específico no design da interface do usuário do 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 propriedade Transitions 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 propriedade Transitions e definir 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 coleção UIElement.Transitions. O VisualTransition é especificamente para animações em grupos de estado visual e é usado pela propriedade VisualStateGroup.Transitions .

Aplica-se a

Confira também