PointAnimation Clase

Definición

Espacio de nombres:

System.Windows.Media.Animation

Ensamblado:

PresentationCore.dll

Anima el valor de una propiedad Point entre dos valores de destino usando la interpolación lineal en un Duration especificado.

public ref class PointAnimation : System::Windows::Media::Animation::PointAnimationBase

public class PointAnimation : System.Windows.Media.Animation.PointAnimationBase

type PointAnimation = class
    inherit PointAnimationBase

Public Class PointAnimation
Inherits PointAnimationBase

Herencia

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

PointAnimationBase

PointAnimation

Comentarios

Una animación actualiza el valor de una propiedad durante un período de tiempo. Un efecto de animación puede ser sutil, como mover unos Shape pocos píxeles a la izquierda y a la derecha, o dramático, como ampliar un objeto a 200 veces su tamaño original mientras gira y cambia su color. Para crear una animación en Windows Presentation Foundation (WPF), debe asociar una animación con el valor de propiedad de un objeto.

Valores de destino

La PointAnimation clase crea una transición entre dos valores de destino. Para establecer sus valores de destino, use sus Frompropiedades , Toy By . En la tabla siguiente se resume cómo las propiedades From, To y By se pueden usar juntas o por separado para determinar los valores de destino de una animación.

Propiedades especificadas	Comportamiento resultante
From	La animación progresa desde el valor especificado por la propiedad From hasta el valor base de la propiedad que se anima o hasta el valor de resultado de una animación previa, en función de la configuración de esta última.
From y To	La animación avanza desde el valor especificado por la propiedad From al valor especificado por la propiedad To.
From y By	La animación avanza desde el valor especificado por la propiedad From al valor especificado por la suma de From y By.
To	La animación progresa desde el valor base de la propiedad animada o desde el valor de salida de una animación previa al valor especificado por la propiedad To.
By	La animación progresa desde el valor base de la propiedad que se anima o desde el valor de salida de una animación previa hasta la suma de ese valor y del valor especificado por la propiedad By.

Nota:

Si establece las To propiedades y By , la To propiedad tiene prioridad y la By propiedad se omite.

Para usar otros métodos de interpolación o animar entre más de dos valores de destino, use un PointAnimationUsingKeyFrames objeto .

Para información sobre la aplicación de varias animaciones a una sola propiedad, vea Información general sobre animaciones de fotogramas clave.

Características de objeto Freezable

Dado que la PointAnimation clase hereda de Freezable, PointAnimation los objetos obtienen varias características especiales, que incluyen lo siguiente: se pueden declarar como recursos, compartidos entre varios objetos, hecho de solo lectura para mejorar el rendimiento, clonado y hecho seguro para subprocesos. Para obtener más información sobre las diferentes características que ofrecen los objetos Freezable, consulte Información general sobre objetos Freezable.

Constructores

PointAnimation()	Inicializa una nueva instancia de la clase PointAnimation.
PointAnimation(Point, Duration)	Inicializa una nueva instancia de la clase PointAnimation que anima hasta el valor especificado durante el tiempo especificado. El valor inicial de la animación es el valor base de la propiedad que se anima o el resultado de otra animación.
PointAnimation(Point, Duration, FillBehavior)	Inicializa una nueva instancia de la clase PointAnimation que anima hasta el valor especificado durante el tiempo especificado y tiene el comportamiento de relleno especificado. El valor inicial de la animación es el valor base de la propiedad que se anima o el resultado de otra animación.
PointAnimation(Point, Point, Duration)	Inicializa una nueva instancia de la clase PointAnimation que anima desde el valor inicial especificado para el valor de destino especificado durante el tiempo especificado.
PointAnimation(Point, Point, Duration, FillBehavior)	Inicializa una nueva instancia de la clase PointAnimation que anima desde el valor inicial especificado para el valor de destino especificado durante el tiempo especificado y tiene el comportamiento de relleno especificado.

Campos

ByProperty	Identifica la propiedad de dependencia By.
EasingFunctionProperty	Identifica la propiedad de dependencia EasingFunction.
FromProperty	Identifica la propiedad de dependencia From.
ToProperty	Identifica la propiedad de dependencia To.

Propiedades

AccelerationRatio	Obtiene o establece un valor que especifica el porcentaje de Duration de la escala de tiempo transcurrido acelerando el paso del tiempo de cero a su velocidad máxima. (Heredado de Timeline)
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. (Heredado de Timeline)
BeginTime	Obtiene o establece la hora a la que debe empezar Timeline. (Heredado de Timeline)
By	Obtiene o establece la cantidad total por la que la animación cambia su valor inicial.
CanFreeze	Obtiene un valor que indica si el objeto se puede convertir en no modificable. (Heredado de Freezable)
DecelerationRatio	Obtiene o establece un valor que especifica el porcentaje de Duration de la escala de tiempo transcurrido desacelerando el paso del tiempo de su velocidad máxima a cero. (Heredado de Timeline)
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
Duration	Obtiene o establece la duración para la que se reproduce esta escala de tiempo, sin contar las repeticiones. (Heredado de Timeline)
EasingFunction	Obtiene o establece la función de aceleración aplicada a esta animación.
FillBehavior	Obtiene o establece un valor que especifica cómo se comporta Timeline una vez que llega al final de su período activo. (Heredado de Timeline)
From	Obtiene o establece el valor inicial de la animación.
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. (Heredado de Animatable)
IsAdditive	Obtiene o establece un valor que indica si el valor actual de la propiedad de destino debe agregarse al valor de inicio de la animación.
IsCumulative	Obtiene o establece un valor que especifica si se acumula el valor de la animación cuando se repite.
IsDestinationDefault	Obtiene un valor que indica si esta animación usa el parámetro defaultDestinationValue del método GetCurrentValue(Object, Object, AnimationClock) como su valor de destino. (Heredado de AnimationTimeline)
IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente. (Heredado de Freezable)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
Name	Obtiene o establece el nombre de este objeto Timeline. (Heredado de Timeline)
RepeatBehavior	Obtiene o establece el comportamiento de repetición de esta escala de tiempo. (Heredado de Timeline)
SpeedRatio	Obtiene o establece la velocidad, relativa a su elemento primario, a la que progresa Timeline. (Heredado de Timeline)
TargetPropertyType	Obtiene el tipo de valor que genera esta animación. (Heredado de PointAnimationBase)
To	Obtiene o establece el valor final de la animación.

Métodos

AllocateClock()	Crea un objeto Clock para este objeto AnimationTimeline. (Heredado de AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado. (Heredado de Animatable)
CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject)
Clone()	Crea un clon modificable de este PointAnimation y hace copias en profundidad de los valores de este objeto. Cuando se copian propiedades de dependencia, este método copia las referencias de recursos y enlaces de datos (aunque podrían no resolverse), pero no copia las animaciones ni sus valores actuales.
CloneCore(Freezable)	Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con valores de propiedad base (no animadas). (Heredado de Freezable)
CloneCurrentValue()	Crea un clon modificable de este objeto Timeline y hace copias en profundidad de sus valores actuales. (Heredado de Timeline)
CloneCurrentValueCore(Freezable)	Convierte esta instancia en un clon modificable (copia en profundidad) del Freezable especificado mediante los valores de propiedad actuales. (Heredado de Freezable)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject)
CreateClock()	Crea un nuevo AnimationClock a partir de este AnimationTimeline. (Heredado de 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 este elemento Timeline tiene elementos secundarios, se crea un árbol de relojes con este elemento Timeline como raíz. (Heredado de Timeline)
CreateInstance()	Inicializa una nueva instancia de la clase Freezable. (Heredado de Freezable)
CreateInstanceCore()	Crea una nueva instancia de PointAnimation.
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
Freeze()	Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Heredado de Freezable)
FreezeCore(Boolean)	Convierte este objeto Timeline en no modificable o determina si se puede convertir en no modificable. (Heredado de Timeline)
GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado del objeto DependencyProperty especificado. (Heredado de Animatable)
GetAsFrozen()	Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas). Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Convierte esta instancia en un clon del objeto Timeline especificado. (Heredado de Timeline)
GetCurrentValue(Object, Object, AnimationClock)	Obtiene el valor actual de la animación. (Heredado de PointAnimationBase)
GetCurrentValue(Point, Point, AnimationClock)	Obtiene el valor actual de la animación. (Heredado de PointAnimationBase)
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. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte esta instancia en un clon inmovilizado del valor de Timeline especificado. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sí sus valores actuales. (Heredado de Timeline)
GetCurrentValueCore(Point, Point, AnimationClock)	Calcula un valor que representa el valor actual de la propiedad que se está animando, como lo determina el PointAnimation.
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetNaturalDuration(Clock)	Devuelve la longitud de una sola iteración de este objeto Timeline. (Heredado de Timeline)
GetNaturalDurationCore(Clock)	Devuelve la longitud de una sola iteración de este objeto AnimationTimeline. (Heredado de AnimationTimeline)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnChanged()	Se le llama cuando el objeto Freezable actual se modifica. (Heredado 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. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Reemplaza la implementación DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado 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 leen miembros de datos que no son propiedades de dependencia. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el evento Changed para Freezable e invoca su método OnChanged(). Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia. (Heredado 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 las API que escriben en miembros de datos que no son propiedades de dependencia. (Heredado de Freezable)

Eventos

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

Consulte también

• PointAnimationUsingKeyFrames
• Freezable