ConnectedAnimation Classe

Definição

Namespace:

Microsoft.UI.Xaml.Media.Animation

Representa uma animação que anima simultaneamente a saída de um elemento e a entrada de outro elemento.

public ref class ConnectedAnimation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

Herança

Object Platform::Object IInspectable ConnectedAnimation

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Animação conectada.

Abra o aplicativo Galeria do WinUI 3 e veja ConnectedAnimation 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.

Comentários

Uma instância ConnectedAnimation é retornada pelos métodos ConnectedAnimationService.GetAnimation e ConnectedAnimationService.PrepareToAnimate .

Quando você chama TryStart, o elemento que você passa para o método deve ter seu tamanho definido no layout. Isso significa que o tamanho do elemento deve ser definido na marcação ou o conteúdo do elemento deve ser totalmente preenchido, para que seu tamanho possa ser calculado pela estrutura XAML. Se o layout fizer parte de um item ListView ou GridView com propriedades associadas, talvez seja necessário atualizar manualmente o conteúdo para se preparar para a animação, pois as associações podem ser atualizadas de forma assíncrona.

Há uma limitação conhecida em que ConnectedAnimation não funciona bem com transições de tema que têm um componente de tradução, incluindo NavigationThemeTransition e EntranceThemeTransition. Recomendamos que você remova essas transições ou suprima a navegação usando SuppressNavigationTransitionInfo ao criar uma experiência com ConnectedAnimation.

Consulte o Exemplo de animação conectada para obter um exemplo completo de ConnectedAnimation.

Propriedades

Configuration	Obtém ou define a configuração que descreve o tipo de animação conectada a ser reproduzida.
IsScaleAnimationEnabled	Obtém ou define um valor que indica se o componente de escala da animação conectada deve ser usado.

Métodos

Cancel()	Interrompe a animação conectada.
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)	Define um CompositionAnimation personalizado para alterar o movimento de uma parte específica da animação conectada.
TryStart(UIElement)	Tenta iniciar a animação.
TryStart(UIElement, IIterable<UIElement>)	Tenta iniciar a animação no elemento de destino e nos elementos secundários especificados.

Eventos

Completed

Ocorre quando a animação é concluída.

Confira também

• ConnectedAnimationService