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(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectedAnimation final
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectedAnimation
[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

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.

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.

Se aplica a

Consulte también