AnimationTimeline (Clase) (System.Windows.Media.Animation)

Cambiar vista:

Sin script

Biblioteca de clases de .NET Framework

AnimationTimeline (Clase)

Este artículo se tradujo de forma manual. Para mostrar esta página y el contenido original en inglés al mismo tiempo, cambie a Lightweight según sus preferencias de visualización.

Define un segmento de hora respecto al que se generan los valores de salida. Estos valores se utilizan para animar una propiedad de destino.

Jerarquía de herencia

Espacio de nombres: System.Windows.Media.Animation
Ensamblado: PresentationCore (en PresentationCore.dll)

Sintaxis

Visual Basic

Public MustInherit Class AnimationTimeline _
	Inherits Timeline

public abstract class AnimationTimeline : Timeline

Visual C++

public ref class AnimationTimeline abstract : public Timeline

[<AbstractClass>]
type AnimationTimeline =  
    class
        inherit Timeline
    end

El tipo AnimationTimeline expone los siguientes miembros.

Constructores

	Nombre	Descripción
	AnimationTimeline	Inicializa una nueva instancia de la clase AnimationTimeline.

Arriba

Propiedades

	Nombre	Descripción
	AccelerationRatio	Obtiene o establece un valor que especifica el porcentaje de la propiedad Duration de la escala de tiempo transcurrido acelerando el paso del tiempo de cero a su máximo. (Se hereda de Timeline).
	AutoReverse	Obtiene o establece un valor que indica si la escala de tiempo retrocede después de completar una iteración de avance. (Se hereda de Timeline).
	BeginTime	Obtiene o establece la hora a la que debe empezar Timeline. (Se hereda de Timeline).
	CanFreeze	Obtiene un valor que indica si el objeto se puede convertir en no modificable. (Se hereda de Freezable).
	DecelerationRatio	Obtiene o establece un valor que especifica el porcentaje de la propiedad Duration de la escala de tiempo transcurrido desacelerando el paso del tiempo desde su velocidad máxima a cero. (Se hereda de Timeline).
	DependencyObjectType	Obtiene el objeto DependencyObjectType que ajusta el tipo CLR de esta instancia. (Se hereda de DependencyObject).
	Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
	Duration	Obtiene o establece la duración para la que se reproduce esta escala de tiempo, sin contar las repeticiones. (Se hereda de Timeline).
	FillBehavior	Obtiene o establece un valor que especifica el comportamiento de Timeline después de que agote su período activo. (Se hereda de Timeline).
	HasAnimatedProperties	Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto. (Se hereda de Animatable).
	IsDestinationDefault	Obtiene un valor que indica si esta animación usa el parámetro valorDeDestinoPredeterminado del método GetCurrentValue como su valor de destino.
	IsFrozen	Obtiene un valor que indica si el objeto es modificable actualmente. (Se hereda de Freezable).
	IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Se hereda de DependencyObject).
	Name	Obtiene o establece el nombre de este objeto Timeline. (Se hereda de Timeline).
	RepeatBehavior	Obtiene o establece el comportamiento de repetición de esta escala de tiempo. (Se hereda de Timeline).
	SpeedRatio	Obtiene o establece la velocidad, relativa a su elemento primario, a la que progresa Timeline. (Se hereda de Timeline).
	TargetPropertyType	Cuando se invalida en una clase derivada, obtiene el objeto Type de la propiedad que se puede animar.

Arriba

Métodos

	Nombre	Descripción
	AllocateClock	Crea un objeto Clock para este objeto AnimationTimeline. (Invalida a Timeline.AllocateClock()).
	ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica un objeto AnimationClock al objeto DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega de SnapshotAndReplace. (Se hereda de Animatable).
	ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica un objeto AnimationClock al objeto DependencyProperty especificado. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado. (Se hereda de Animatable).
	BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación al objeto DependencyProperty especificado. La animación empieza cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega de SnapshotAndReplace. (Se hereda de Animatable).
	BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación al objeto DependencyProperty especificado. La animación empieza cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado. (Se hereda de Animatable).
	CheckAccess	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Se hereda de DispatcherObject).
	ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador de DependencyProperty. (Se hereda de DependencyObject).
	ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de sólo lectura. DependencyPropertyKey especifica la propiedad que se va a borrar. (Se hereda de DependencyObject).
	Clone	Crea un clon modificable de este objeto AnimationTimeline y hace copias en profundidad de sus valores. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque no se resuelvan), pero no copia las animaciones ni sus valores actuales.
	CloneCore	Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con los valores de la propiedad base (no animada). (Se hereda de Freezable).
	CloneCurrentValue	Crea un clon modificable de este objeto Timeline y hace copias en profundidad de sus valores actuales. (Se hereda de Timeline).
	CloneCurrentValueCore	Convierte la instancia en un clon modificable (en profundidad) del objeto Freezable especificado utilizando los valores de las propiedades actuales. (Se hereda de Freezable).
	CoerceValue	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función de CoerceValueCallback especificada en los metadatos de la propiedad de dependencia cuando existe en el objeto DependencyObject de llamada. (Se hereda de DependencyObject).
	CreateClock()	Crea un nuevo objeto AnimationClock a partir de este objeto AnimationTimeline.
	CreateClock(Boolean)	Crea un nuevo objeto Clock a partir de este objeto Timeline y especifica si el nuevo objeto Clock se puede controlar. Si Timeline tiene elementos secundarios, se crea un árbol de relojes con Timeline como la raíz. (Se hereda de Timeline).
	CreateInstance	Inicializa una nueva instancia de la clase Freezable. (Se hereda de Freezable).
	CreateInstanceCore	Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada. (Se hereda de Freezable).
	Equals	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Se hereda de DependencyObject).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	Freeze()	Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Se hereda de Freezable).
	FreezeCore	Convierte este objeto Timeline en no modificable o determina si se puede convertir en no modificable. (Se hereda de Timeline).
	GetAnimationBaseValue	Devuelve el valor no animado del objeto DependencyProperty especificado. (Se hereda de Animatable).
	GetAsFrozen	Crea una copia inmovilizada de Freezable, con los valores de la propiedad base (no animada). Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
	GetAsFrozenCore	Convierte esta instancia en un clon del objeto Timeline especificado. (Se hereda de Timeline).
	GetCurrentValue	Obtiene el valor actual de la animación.
	GetCurrentValueAsFrozen	Crea una copia inmovilizada de Freezable con los valores de propiedad actuales. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
	GetCurrentValueAsFrozenCore	Convierte esta instancia en un clon inmovilizado del objeto Timeline especificado. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sus valores actuales sí. (Se hereda de Timeline).
	GetHashCode	Obtiene un código hash de este objeto DependencyObject. (Se hereda de DependencyObject).
	GetLocalValueEnumerator	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Se hereda de DependencyObject).
	GetNaturalDuration	Devuelve la duración de una sola iteración de este objeto Timeline. (Se hereda de Timeline).
	GetNaturalDurationCore	Devuelve la longitud de una sola iteración de este objeto AnimationTimeline. (Invalida a Timeline.GetNaturalDurationCore(Clock)).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	GetValue	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
	InvalidateProperty	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Se hereda de DependencyObject).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	OnChanged	Se llama cuando se modifica el objeto Freezable actual. (Se hereda de Freezable).
	OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer. (Se hereda de Freezable).
	OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no se debe usar directamente desde el código. (Se hereda de Freezable).
	OnPropertyChanged	Invalida la implementación de DependencyObject de OnPropertyChanged para invocar también cualquier controlador Changed como respuesta a un cambio de propiedad de dependencia de tipo Freezable. (Se hereda de Freezable).
	ReadLocalValue	Devuelve el valor local de una propiedad de dependencia, si existe. (Se hereda de DependencyObject).
	ReadPreamble	Se asegura de que se tiene acceso a Freezable desde un subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de las API que lean miembros de datos que no son propiedades de dependencia. (Se hereda de Freezable).
	SetCurrentValue	Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor. (Se hereda de DependencyObject).
	SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Se hereda de DependencyObject).
	SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de sólo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Se hereda de DependencyObject).
	ShouldSerializeProperty	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Se hereda de DependencyObject).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	VerifyAccess	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
	WritePostscript	Provoca el evento Changed de Freezable e invoca su método OnChanged. Las clases que se derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no se almacenen como propiedades de dependencia. (Se hereda de Freezable).
	WritePreamble	Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Se hereda de Freezable).

Arriba

Eventos

	Nombre	Descripción
	Changed	Se produce cuando se modifican la clase Freezable o un objeto que la contiene. (Se hereda de Freezable).
	Completed	Se produce cuando esta escala de tiempo ha terminado de reproducirse totalmente: ya no especificará su período activo. (Se hereda de Timeline).
	CurrentGlobalSpeedInvalidated	Se produce cuando cambia la velocidad de progreso del reloj de la escala de tiempo. (Se hereda de Timeline).
	CurrentStateInvalidated	Se produce cuando se actualiza la propiedad CurrentState de Clock de la escala de tiempo. (Se hereda de Timeline).
	CurrentTimeInvalidated	Se produce cuando se actualiza la propiedad CurrentTime de Clock de la escala de tiempo. (Se hereda de Timeline).
	RemoveRequested	Se produce cuando se quita el reloj creado para esta escala de tiempo o una de sus escalas de tiempo primarias. (Se hereda de Timeline).

Arriba

Campos

	Nombre	Descripción
	IsAdditiveProperty	Identifica la propiedad de dependencia de IsAdditive.
	IsCumulativeProperty	Identifica la propiedad de dependencia de IsCumulative.

Arriba

Comentarios

AnimationTimeline es un tipo del objeto Timeline que genera valores de salida basándose en su progreso del control de tiempo. Todos los tipos de animación heredan de AnimationTimeline.

Características de los elementos Freezable: como la clase AnimationTimeline se hereda de la clase Freezable, proporciona varias características especiales: los objetos AnimationTimeline pueden declararse como recursos, compartirse entre varios objetos, convertirse en objetos de solo lectura para mejorar el rendimiento, clonarse y definirse como seguros para la ejecución de subprocesos. Para obtener más información sobre las diferentes características que proporcionan los objetos Freezable, consulte Información general sobre objetos Freezable.

Notas para los herederos

Para crear una animación personalizada, invalide o implemente los miembros siguientes:

CreateInstanceCore: si la nueva clase es concreta, debe invalidar CreateInstanceCore para devolver una nueva instancia de la clase.
GetCurrentValue: invalide este método para devolver el valor actual de la animación. Acepta tres parámetros: un valor de origen predeterminado, un valor de destino predeterminado y un objeto AnimationClock. Utilice AnimationClock para obtener la hora actual o el progreso de la animación. Puede decidir si usar los valores de origen y destino predeterminados.
IsDestinationDefault: invalide esta propiedad para indicar si la animación usa el valor de destino predeterminado especificado por el método GetCurrentValue.
TargetPropertyType: invalide esta propiedad para indicar el objeto Type de salida que genera la animación.

Si la clase no utiliza propiedades de dependencia para almacenar sus datos o requiere que se inicialice otra vez después de haberse creado, es posible que tenga que invalidar otros métodos; consulte Información general sobre objetos Freezable para obtener más información.

Para obtener más información sobre cómo crear animaciones personalizadas, vea Información general sobre animaciones personalizadas.

Información de versión

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Plataformas

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

System.Windows.Media.Animation (Espacio de nombres)

Otros recursos

Información general sobre animaciones personalizadas

Custom Animation Sample

Información general sobre animaciones

Información general sobre animaciones de fotogramas clave

Información general sobre objetos Storyboard

Jerarquía de herencia