Lenguaje

ConnectedAnimation Clase

Definición

Representa una animación que anima simultáneamente la salida de un elemento y la entrada de otro elemento.

public ref class ConnectedAnimation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation
Public NotInheritable Class ConnectedAnimation
Herencia
Object Platform::Object IInspectable ConnectedAnimation
Atributos

Ejemplos

Tip

Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Animación conectada.

La aplicación WinUI 3 Gallery incluye ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 3. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.

Comentarios

Los métodos ConnectedAnimation y ConnectedAnimationService.GetAnimation y ConnectedAnimationService.PrepareToAnimate devuelven una instancia de ConnectedAnimationService.

Al llamar a TryStart, el elemento que pasa al método debe tener su tamaño definido en el diseño. Esto significa que el tamaño del elemento debe establecerse en el marcado o que el contenido del elemento debe rellenarse completamente, de modo que el marco XAML pueda calcular su tamaño. Si el diseño forma parte de un elemento ListView o GridView con propiedades enlazadas, es posible que tenga que actualizar manualmente el contenido para prepararse para la animación porque los enlaces se pueden actualizar de forma asincrónica.

Hay una limitación conocida en la que ConnectedAnimation no funciona bien con transiciones de tema que tienen un componente de traducción, incluido NavigationThemeTransition y EntranceThemeTransition. Se recomienda quitar estas transiciones o suprimir la navegación mediante SuppressNavigationTransitionInfo, al crear una experiencia con ConnectedAnimation.

Consulta el ejemplo de animación conectada para obtener un ejemplo completo de ConnectedAnimation.

Propiedades

Nombre Description
Configuration

Obtiene o establece la configuración que describe el tipo de animación conectada que se va a reproducir.

IsScaleAnimationEnabled

Obtiene o establece un valor que indica si se debe usar el componente de escalado de la animación conectada.

Métodos

Nombre Description
Cancel()

Detiene la animación conectada.

SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)

Establece una compositionAnimation personalizada para cambiar el movimiento de una parte determinada de la animación conectada.

TryStart(UIElement, IIterable<UIElement>)

Intenta iniciar la animación en el elemento de destino y en los elementos secundarios especificados.

TryStart(UIElement)

Intenta iniciar la animación.

Eventos

Nombre Description
Completed

Se produce cuando finaliza la animación.

Se aplica a

Consulte también