Partilhar via


ConnectedAnimationService Classe

Definição

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

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.

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.

Aplica-se a

Confira também