ConnectedAnimation Classe

Definição

Namespace:

Windows.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(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[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

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Exemplos

Dica

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

Se você tiver o aplicativo WinUI 2 Gallery instalado, clique aqui para abrir o aplicativo e ver Animação Conectada em ação.

• Obtenha o aplicativo WinUI 2 Gallery (Microsoft Store)
• Obtenha o código-fonte (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 EntryThemeTransition. É recomendável remover essas transições ou suprimir 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.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	IsScaleAnimationEnabled
1703	15063	SetAnimationComponent
1703	15063	TryStart(UIElement,IEnumerable<UIElement>)
1809	17763	Configuração

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 uma CompositionAnimation personalizada 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