Timeline 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í.
Define una duración y otras propiedades de comportamiento para una animación de Windows Runtime. Timeline es la clase base para Storyboard y todos los tipos de animación de Windows Runtime, incluidos los de la biblioteca de animaciones y los usados para animaciones personalizadas en estados visuales o XAML de nivel de página.
public ref class Timeline : DependencyObject
/// [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 Timeline : DependencyObject
[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 class Timeline : DependencyObject
Public Class Timeline
Inherits DependencyObject
- Herencia
- Derivado
- Atributos
Comentarios
Timeline define la propiedad Duration que controla cuánto tiempo se ejecuta una animación una vez iniciada. Timeline también define estas propiedades de comportamiento, que son comunes a todos los tipos de animaciones y a Storyboard:
- AutoReverse
- BeginTime
- FillBehavior
- RepeatBehavior
- SpeedRatio (no se usa con frecuencia)
Timeline también define el evento Completed para storyboard y animaciones. Controlar el evento Completed no es necesario o la mayoría de los escenarios de animación de la interfaz de usuario.
La relación entre Storyboard y los tipos de animación es que un Guión gráfico es un contenedor que puede agrupar varias animaciones y actúa como controlador para iniciar y detener las animaciones contenidas. Al establecer las propiedades timeline en un Guión gráfico en lugar de animaciones individuales dentro de un Guión gráfico, las propiedades timeline establecidas en storyboard normalmente invalidan las de las animaciones combinadas. Para obtener más información, consulta Animaciones con guion gráfico.
Timeline tiene una clase de colección fuertemente tipada que se usa para las propiedades que toman un conjunto de valores timeline, como Storyboard.Children. Para obtener más información, consulta TimelineCollection.
Clases derivadas de escala de tiempo
Timeline es la clase primaria para varias clases derivadas inmediatamente que admiten el sistema de animación con guion gráfico y también las animaciones de biblioteca integradas. Estas son algunas de las clases derivadas importantes:
Guión gráfico: contenedor y controlador para otras animaciones con guion gráfico que cada una tiene como destino un objeto y una propiedad concretos.
Animaciones con tipo: cada una de ellas se usa para animar una propiedad que toma un tipo de valor determinado o un objeto . + ColorAnimation, ColorAnimationUsingKeyFrames
Animaciones de tema: estas son animaciones definidas por la biblioteca de animaciones que se usan para interacciones comunes de la interfaz de usuario.+ DragItemThemeAnimation
Nota
Las transiciones de tema no derivan de la escala de tiempo, se derivan de la transición.
Constructores
Timeline() |
Proporciona el comportamiento de inicialización de clases base para las clases derivadas de la escala de tiempo. |
Propiedades
AllowDependentAnimations |
Obtiene o establece un valor que determina si se deben permitir animaciones dependientes para ejecutarse en toda la aplicación. |
AutoReverse |
Obtiene o establece un valor que indica si la escala de tiempo se reproduce en orden inverso después de completar una iteración de avance. |
AutoReverseProperty |
Identifica la propiedad de dependencia AutoReverse . |
BeginTime |
Obtiene o establece la hora en la que debe comenzar esta escala de tiempo . |
BeginTimeProperty |
Identifica la propiedad de dependencia BeginTime . |
Dispatcher |
Siempre devuelve |
DispatcherQueue |
Obtiene el objeto |
Duration |
Obtiene o establece la duración para la que se reproduce esta escala de tiempo, sin contar las repeticiones. |
DurationProperty |
Identifica la propiedad de dependencia Duration . |
FillBehavior |
Obtiene o establece un valor que especifica cómo se comporta la animación después de que llegue al final de su período activo. |
FillBehaviorProperty |
Identifica la propiedad de dependencia FillBehavior . |
RepeatBehavior |
Obtiene o establece el comportamiento de repetición de esta escala de tiempo. |
RepeatBehaviorProperty |
Identifica la propiedad de dependencia RepeatBehavior . |
SpeedRatio |
Obtiene o establece la velocidad, en relación con su elemento primario, en cuyo momento progresa para esta escala de tiempo. |
SpeedRatioProperty |
Identifica la propiedad de dependencia SpeedRatio . |
Métodos
ClearValue(DependencyProperty) |
Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject) |
GetAnimationBaseValue(DependencyProperty) |
Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject) |
GetValue(DependencyProperty) |
Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject) |
ReadLocalValue(DependencyProperty) |
Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject) |
SetValue(DependencyProperty, Object) |
Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject) |
Eventos
Completed |
Se produce cuando se ha completado la reproducción del objeto Storyboard . |