Animatable.ApplyAnimationClock Método

Definición

Anima el objeto DependencyProperty con el objeto AnimationClock especificado.Animates the specified DependencyProperty using the specified AnimationClock.

Sobrecargas

ApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado.If the property is already animated, the specified HandoffBehavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock);
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);
abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock)

Parámetros

dp
DependencyProperty

Propiedad que se va a animar.The property to animate.

clock
AnimationClock

Reloj con el que se animará la propiedad especificada.The clock with which to animate the specified property. Si clock es null, se quitarán todas las animaciones de la propiedad especificada (pero no se detendrán).If clock is null, all animations will be removed from the specified property (but not stopped).

Implementaciones

Comentarios

Tenga en cuenta que el uso de este método para quitar los relojes de una propiedad no detiene esos relojes.Note that using this method to removing clocks from a property does not stop those clocks.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado.If the property is already animated, the specified HandoffBehavior is used.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);
abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit

Parámetros

dp
DependencyProperty

Propiedad que se va a animar.The property to animate.

clock
AnimationClock

Reloj con el que se animará la propiedad especificada.The clock with which to animate the specified property. Si handoffBehavior es SnapshotAndReplace y clock es null, todas las animación se quitarán de la propiedad especificada (pero no se detendrán).If handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). Si handoffBehavior es Compose y el reloj es null, este método no tiene ningún efecto.If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior

Valor que especifica la interacción de la nueva animación con cualquier animación actual que ya afecte el valor de propiedad.A value that specifies how the new animation should interact with any current animations already affecting the property value.

Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar los relojes de animación HandoffBehavior con distintos valores.The following example shows how to apply animation clocks using different HandoffBehavior settings.

Comentarios

Tenga en cuenta que el uso de este método para quitar los relojes de una propiedad no detiene esos relojes.Note that using this method to remove clocks from a property does not stop those clocks.

Usar el HandoffBehavior ComposeUsing the Compose HandoffBehavior

Cuando se aplica un Storyboard, AnimationTimelineo AnimationClock a una propiedad mediante el Compose HandoffBehavior, todos Clock los objetos asociados previamente a esa propiedad continúan consumiendo recursos del sistema; el sistema de control de tiempo no se Quite estos relojes automáticamente.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system will not remove these clocks automatically.

Para evitar problemas de rendimiento al aplicar un gran número de relojes mediante Compose, debe quitar los relojes de composición de la propiedad animada una vez completados.To avoid performance issues when you apply a large number of clocks using Compose, you should remove composing clocks from the animated property after they complete. Hay varias formas de quitar un reloj.There are several ways to remove a clock.

Este problema se produce principalmente en las animaciones de objetos que tienen un período de duración prolongado.This is primarily an issue for animations on objects that have a long lifetime. Cuando un objeto se recolecta como elemento no utilizado, sus relojes también se desconectan y se recolectan como elementos no utilizados.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

Para obtener más información sobre los objetos de reloj, consulte información general sobre el sistema de control de tiempo y animación.For more information about clock objects, see the Animation and Timing System Overview.

Se aplica a