RectAnimation Clase

Definición

Espacio de nombres:

System.Windows.Media.Animation

Ensamblado:

PresentationCore.dll

Anima el valor de una Rect propiedad entre dos valores de destino mediante interpolación lineal.

public ref class RectAnimation : System::Windows::Media::Animation::RectAnimationBase

public class RectAnimation : System.Windows.Media.Animation.RectAnimationBase

type RectAnimation = class
    inherit RectAnimationBase

Public Class RectAnimation
Inherits RectAnimationBase

Herencia

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

RectAnimationBase

RectAnimation

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 de izquierda y 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), asocia una animación con el valor de propiedad de un objeto.

Valores de destino

La RectAnimation 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 se pueden usar las Frompropiedades , Toy By juntas o por separado para determinar los valores de destino de una animación.

Propiedades especificadas	Comportamiento resultante
From	La animación avanza desde el valor especificado por la From propiedad hasta el valor base de la propiedad que se está animando o hasta el valor de salida de una animación anterior, dependiendo de cómo se configure la animación anterior.
From y To	La animación avanza desde el valor especificado por la From propiedad hasta el valor especificado por la To propiedad .
From y By	La animación avanza del valor especificado por la From propiedad al valor especificado por la suma de las From propiedades y By .
To	La animación avanza desde el valor base de la propiedad animada o el valor de salida de una animación anterior al valor especificado por la To propiedad .
By	La animación avanza desde el valor base de la propiedad que se está animando o el valor de salida de una animación anterior hasta la suma de ese valor y el valor especificado por la By propiedad .

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 RectAnimationUsingKeyFrames objeto .

Para obtener información sobre cómo aplicar varias animaciones a una sola propiedad, consulte Key-Frame Información general sobre animaciones.

Características de Freezable

Dado que la RectAnimation clase hereda de Freezable, RectAnimation los objetos obtienen varias características especiales, que incluyen lo siguiente: se pueden declarar como recursos, que se comparten entre varios objetos, hacen de solo lectura para mejorar el rendimiento, clonado y hacer que el subproceso sea seguro. Para obtener más información sobre las distintas características proporcionadas por Freezable los objetos, vea Información general sobre objetos freezable.

Constructores

Nombre	Description
RectAnimation()	Inicializa una nueva instancia de la clase RectAnimation.
RectAnimation(Rect, Duration, FillBehavior)	Inicializa una nueva instancia de la RectAnimation clase que anima al valor especificado durante la duración especificada y tiene el comportamiento de relleno especificado. El valor inicial de la animación es el valor base de la propiedad que se está animando o la salida de otra animación.
RectAnimation(Rect, Duration)	Inicializa una nueva instancia de la RectAnimation clase que anima al valor especificado durante la duración especificada. El valor inicial de la animación es el valor base de la propiedad que se está animando o la salida de otra animación.
RectAnimation(Rect, Rect, Duration, FillBehavior)	Inicializa una nueva instancia de la RectAnimation clase que anima desde el valor inicial especificado al valor de destino especificado durante la duración especificada y tiene el comportamiento de relleno especificado.
RectAnimation(Rect, Rect, Duration)	Inicializa una nueva instancia de la RectAnimation clase que anima desde el valor inicial especificado al valor de destino especificado durante la duración especificada.

Campos

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

Propiedades

Nombre	Description
AccelerationRatio	Obtiene o establece un valor que especifica el porcentaje del Duration tiempo invertido en acelerar el paso del tiempo de cero a su tasa máxima. (Heredado de Timeline)
AutoReverse	Obtiene o establece un valor que indica si la escala de tiempo se reproduce inverso después de completar una iteración hacia delante. (Heredado de Timeline)
BeginTime	Obtiene o establece la hora en la que debe comenzar.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 hacer no modificable. (Heredado de Freezable)
DecelerationRatio	Obtiene o establece un valor que especifica el porcentaje del Duration tiempo invertido en ralentizar el paso del tiempo de su tasa 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 al que DispatcherDispatcherObject está asociado. (Heredado de DispatcherObject)
Duration	Obtiene o establece el período de tiempo durante el que se reproduce esta escala de tiempo, sin contar 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 Timeline se comporta después de que alcance el 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 varios AnimationClock objetos están asociados 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 inicial de esta animación.
IsCumulative	Obtiene o establece un valor que especifica si el valor de la animación se acumula cuando se repite.
IsDestinationDefault	Obtiene un valor que indica si esta animación usa el parámetro defaultDestinationValue del GetCurrentValue(Object, Object, AnimationClock) método 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 (solo lectura). (Heredado de DependencyObject)
Name	Obtiene o establece el nombre de este Timelineobjeto . (Heredado de Timeline)
RepeatBehavior	Obtiene o establece el comportamiento repetido de esta escala de tiempo. (Heredado de Timeline)
SpeedRatio	Obtiene o establece la velocidad, relativa a su elemento primario, en el que avanza el tiempo para este Timelineobjeto . (Heredado de Timeline)
TargetPropertyType	Obtiene el tipo de valor que genera esta animación. (Heredado de RectAnimationBase)
To	Obtiene o establece el valor final de la animación.

Métodos

Nombre	Description
AllocateClock()	Crea un Clock para este AnimationTimelineobjeto . (Heredado de AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica un AnimationClock objeto al especificado DependencyProperty. Si la propiedad ya está animada, se usa el especificado HandoffBehavior . (Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica un AnimationClock objeto al especificado DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace . (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación al especificado DependencyProperty. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el especificado HandoffBehavior . (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación al especificado DependencyProperty. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace . (Heredado de Animatable)
CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. Un identificador especifica DependencyProperty la propiedad que se va a borrar. (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 .DependencyPropertyKey (Heredado de DependencyObject)
Clone()	Crea un clon modificable de este RectAnimationobjeto , haciendo copias profundas de los valores de este objeto.
CloneCore(Freezable)	Convierte la instancia en un clon (copia profunda) del especificado Freezable mediante valores de propiedad base (no animados). (Heredado de Freezable)
CloneCurrentValue()	Crea un clon modificable de este Timeline objeto, haciendo copias profundas de los valores actuales de este objeto. (Heredado de Timeline)
CloneCurrentValueCore(Freezable)	Convierte la instancia en un clon modificable (copia profunda) del especificado Freezable mediante los valores de propiedad actuales. (Heredado de Freezable)
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier CoerceValueCallback función especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada DependencyObjecta . (Heredado de DependencyObject)
CreateClock()	Crea un nuevo AnimationClock a partir de este AnimationTimelineobjeto . (Heredado de AnimationTimeline)
CreateClock(Boolean)	Crea un nuevo Clock a partir de este Timeline objeto y especifica si el nuevo Clock es controlable. Si tiene Timeline elementos secundarios, se crea un árbol de relojes con esto 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 .RectAnimation
Equals(Object)	Determina si un proporcionado DependencyObject es equivalente al objeto actual DependencyObject. (Heredado de DependencyObject)
Freeze()	Hace que el objeto actual no se pueda modificar y establezca su IsFrozen propiedad trueen . (Heredado de Freezable)
FreezeCore(Boolean)	Hace que esto Timeline no se pueda modificar o determina si se puede hacer no modificable. (Heredado de Timeline)
GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado del especificado DependencyProperty. (Heredado de Animatable)
GetAsFrozen()	Crea una copia inmovilizada de , Freezablemediante valores de propiedad base (no animados). Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Convierte esta instancia en un clon del objeto especificado Timeline . (Heredado de Timeline)
GetCurrentValue(Object, Object, AnimationClock)	Obtiene el valor actual de la animación. (Heredado de RectAnimationBase)
GetCurrentValue(Rect, Rect, AnimationClock)	Obtiene el valor actual de la animación. (Heredado de RectAnimationBase)
GetCurrentValueAsFrozen()	Crea una copia inmovilizada de mediante los valores de Freezable propiedad actuales. Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte esta instancia en un clon inmovilizado del especificado Timeline. Las referencias de recursos, los enlaces de datos y las animaciones no se copian, pero sus valores actuales son. (Heredado de Timeline)
GetCurrentValueCore(Rect, Rect, AnimationClock)	Calcula un valor que representa el valor actual de la propiedad que se está animando, según lo determinado por .RectAnimation
GetHashCode()	Obtiene un código hash para este DependencyObjectobjeto . (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetNaturalDuration(Clock)	Devuelve la longitud de una sola iteración de este Timeline. (Heredado de Timeline)
GetNaturalDurationCore(Clock)	Devuelve la longitud de una sola iteración de este AnimationTimeline. (Heredado de AnimationTimeline)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de .DependencyObject (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
OnChanged()	Se llama cuando se modifica el objeto actual Freezable . (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)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantiza que los punteros de contexto adecuados se establecen para un DependencyObjectType miembro de datos que se acaba de establecer. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invalida la DependencyObject implementación de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también los Changed controladores 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()	Garantiza que Freezable se accede a desde un subproceso válido. Los heredadores de Freezable deben llamar a este método al principio de cualquier API que lea miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el DependencyPropertyKey identificador 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 proporcionada. (Heredado de DependencyObject)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el Changed evento para e Freezable invoca su OnChanged() método . Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique los miembros de clase que no se almacenan como propiedades de dependencia. (Heredado de Freezable)
WritePreamble()	Comprueba que Freezable no está inmovilizado y que se accede a él desde un contexto de subproceso válido. Freezable Los heredares deben llamar a este método al principio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)

Eventos

Nombre	Description
Changed	Se produce cuando se modifica o Freezable un objeto que contiene. (Heredado de Freezable)
Completed	Se produce cuando esta escala de tiempo ha terminado de reproducirse completamente: ya no entrará en su período activo. (Heredado de Timeline)
CurrentGlobalSpeedInvalidated	Se produce cuando cambia la velocidad a la que avanza el tiempo para el reloj de la escala de tiempo. (Heredado de Timeline)
CurrentStateInvalidated	Se produce cuando se actualiza la CurrentState propiedad de la escala de tiempo Clock . (Heredado de Timeline)
CurrentTimeInvalidated	Se produce cuando se actualiza la CurrentTime propiedad de la escala de tiempo Clock . (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

• RectAnimationUsingKeyFrames
• Freezable