Partilhar via


ConnectedAnimation Classe

Definição

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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectedAnimation final
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectedAnimation
[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

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.

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.

Aplica-se a

Confira também