ConnectedAnimation Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Media.Animation

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(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)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

Herencia

Object Platform::Object IInspectable ConnectedAnimation

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Ejemplos

Sugerencia

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

Si tienes instalada la aplicación Galería de WinUI 2 , haz clic aquí para abrir la aplicación y consulta Animación conectada en acción.

• Obtenga la aplicación WinUI 2 Gallery (Microsoft Store)
• Obtener el código fuente (GitHub)

Comentarios

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

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.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1703	15063	IsScaleAnimationEnabled
1703	15063	SetAnimationComponent
1703	15063	TryStart(UIElement,IEnumerable<UIElement>)
1809	17763	Configuración

Propiedades

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

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)	Intenta iniciar la animación.
TryStart(UIElement, IIterable<UIElement>)	Intenta iniciar la animación en el elemento de destino y en los elementos secundarios especificados.

Eventos

Completed

Se produce cuando finaliza la animación.

Consulte también

• ConnectedAnimationService