ConnectedAnimationService Classe

Definição

Namespace:

Microsoft.UI.Xaml.Media.Animation

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

public ref class ConnectedAnimationService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[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

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 consulte 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.

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 ao elemento de origem e chave especificados.

Confira também

• Visão geral da animação conectada