BeginStoryboard.HandoffBehavior Propiedad

public:
 property System::Windows::Media::Animation::HandoffBehavior HandoffBehavior { System::Windows::Media::Animation::HandoffBehavior get(); void set(System::Windows::Media::Animation::HandoffBehavior value); };

public System.Windows.Media.Animation.HandoffBehavior HandoffBehavior { get; set; }

member this.HandoffBehavior : System.Windows.Media.Animation.HandoffBehavior with get, set

Public Property HandoffBehavior As HandoffBehavior

Valor de propiedad

Uno de los HandoffBehavior valores de enumeración. El valor por defecto es SnapshotAndReplace.

Comentarios

Uso de Compose HandoffBehavior

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

Para evitar problemas de rendimiento al aplicar un gran número de relojes mediante Compose, debe eliminar los relojes componedores de la propiedad animada una vez que hayan sido completados. Hay varias maneras de quitar un reloj:

• Para quitar todos los relojes de la 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 elemento específico AnimationClock de una lista de relojes, use la Controller propiedad de AnimationClock para recuperar un ClockController objeto y, a continuación, llame al método Remove de ClockController. Normalmente, esto se hace en el Completed controlador de eventos de un reloj. Tenga en cuenta que solo los relojes raíz se pueden controlar mediante ; ClockControllerla Controller propiedad de un reloj secundario devuelve null. Tenga en cuenta también que no se llama al Completed evento si la duración efectiva del reloj es indefinida. En ese caso, el usuario debe determinar cuándo llamar Removea .

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

Para obtener más información sobre los objetos de reloj, vea Animation and Timing System Overview.