Animatable.ApplyAnimationClock Método

Definición

Espacio de nombres:

System.Windows.Media.Animation

Ensamblado:

PresentationCore.dll

Anima el DependencyProperty especificado mediante el AnimationClockespecificado.

Sobrecargas

ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el HandoffBehavior especificado.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.

C#

public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);

Parámetros

dp

DependencyProperty

Propiedad que se va a animar.

clock

AnimationClock

Reloj con el que se va a animar la propiedad especificada. Si clock es null, todas las animaciones se quitarán de la propiedad especificada (pero no se detendrán).

Implementaciones

ApplyAnimationClock(DependencyProperty, AnimationClock)

Comentarios

Tenga en cuenta que el uso de este método para quitar relojes de una propiedad no detiene esos relojes.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el HandoffBehavior especificado.

C#

public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

Parámetros

dp

DependencyProperty

Propiedad que se va a animar.

clock

AnimationClock

Reloj con el que se va a animar la propiedad especificada. Si handoffBehavior es SnapshotAndReplace y clock es null, todas las animaciones se quitarán de la propiedad especificada (pero no se detendrán). Si handoffBehavior es Compose y el reloj es null, este método no tiene ningún efecto.

handoffBehavior

HandoffBehavior

Valor que especifica cómo la nueva animación debe interactuar con cualquier animación actual que ya afecte al valor de propiedad.

Implementaciones

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar relojes de animación mediante diferentes configuraciones de HandoffBehavior.

Comentarios

Tenga en cuenta que el uso de este método para quitar relojes de una propiedad no detiene esos relojes.

Uso de Compose HandoffBehavior

Cuando se aplica un Storyboard, AnimationTimelineo AnimationClock a una propiedad mediante el ComposeHandoffBehavior, los objetos Clock asociados previamente a esa propiedad siguen usando recursos del sistema; el sistema de control de tiempo no quitará estos relojes automáticamente.

Para evitar problemas de rendimiento al aplicar un gran número de relojes mediante Compose, debe quitar la composición de los relojes de la propiedad animada después de completarlos. Hay varias maneras de quitar un reloj.

• Para quitar todos los relojes de una propiedad, use el método ApplyAnimationClock(DependencyProperty, AnimationClock) o BeginAnimation(DependencyProperty, AnimationTimeline) del objeto animado. Especifique la propiedad que se está animando como primer parámetro y null como segundo. Esto quitará todos los relojes de animación de la propiedad .

• Para quitar un AnimationClock específico de una lista de relojes, use la propiedad Controller del AnimationClock para recuperar un ClockControllery, a continuación, llame al método Remove del ClockController. Normalmente, esto se hace en el controlador de eventos Completed para un reloj. Tenga en cuenta que solo un ClockControllerpuede controlar los relojes raíz; la propiedad Controller de un reloj secundario devolverá null. Tenga en cuenta también que no se llamará al evento Completed si la duración efectiva del reloj es indefinida. En ese caso, el usuario tendrá que determinar cuándo llamar a Remove.

Esto es principalmente un problema para animaciones en objetos que tienen una larga duración. Cuando se recolecte un objeto, sus relojes también se desconectarán y se recopilarán elementos no utilizados.

Para obtener más información sobre los objetos de reloj, vea la Animación e Información general del sistema de tiempo.