ConnectedAnimation Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Atributos
Ejemplos
Sugerencia
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, las características y la funcionalidad 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 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 tengas que actualizar manualmente el contenido para preparar 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, incluidos 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
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 escala 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. |