ConnectedAnimationService Classe

Definição

Namespace:

Windows.UI.Xaml.Media.Animation

Representa um serviço que fornece propriedades e métodos para exibir um ConnectedAnimation.

public ref class ConnectedAnimationService 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 ConnectedAnimationService 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 ConnectedAnimationService

Public NotInheritable Class ConnectedAnimationService

Herança

Object Platform::Object IInspectable ConnectedAnimationService

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 Galeria do WinUI 2 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)

Este exemplo mostra como animar uma imagem entre duas páginas durante uma navegação.

SourcePage.xaml/SourcePage.xaml.cs

<Image x:Name="SourceImage"
       Width="200"
       Height="200"
       Stretch="Fill"
       Source="Assets/StoreLogo.png" />

private void NavigateToDestinationPage()
{
    ConnectedAnimationService.GetForCurrentView().PrepareToAnimate("image", SourceImage);
    Frame.Navigate(typeof(DestinationPage));
}

DestinationPage.xaml/DestinationPage.xaml.cs

<Image x:Name="DestinationImage"
       Width="400"
       Height="400"
       Stretch="Fill"
       Source="Assets/StoreLogo.png" />

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    base.OnNavigatedTo(e);

    ConnectedAnimation imageAnimation = 
        ConnectedAnimationService.GetForCurrentView().GetAnimation("image");
    if (imageAnimation != null)
    {
        imageAnimation.TryStart(DestinationImage);
    }
}

Comentários

Para obter uma instância de ConnectedAnimationService, chame o método GetForCurrentView estático.

Ao chamar PrepareToAnimate, você fornece uma chave para associar ao ConnectedAnimation recém-criado retornado pelo método . Posteriormente, você pode usar essa chave para recuperar a mesma animação chamando GetAnimation. Isso permite que você conecte a animação entre duas páginas diferentes sem precisar passar manualmente a referência ao objeto ConnectedAnimation entre páginas.

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

Propriedades

DefaultDuration	Obtém ou define a hora padrão em que a animação é executada.
DefaultEasingFunction	Obtém ou define o CompositionEasingFunction padrão usado pela animação.

Métodos

GetAnimation(String)	Retorna a animação com a chave especificada.
GetForCurrentView()	Retorna uma instância de ConnectedAnimationService para a exibição atual.
PrepareToAnimate(String, UIElement)	Retorna uma animação conectada associada à chave e ao elemento de origem especificados.

Confira também

• Visão geral da animação conectada