BeginStoryboard.HandoffBehavior Proprietà

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

Valore della proprietà

Uno dei valori di HandoffBehavior enumerazione. Il valore predefinito è SnapshotAndReplace.

Commenti

Uso di Compose HandoffBehavior

Quando si applica una Storyboardproprietà , AnimationTimelineo AnimationClock a una proprietà utilizzando HandoffBehavior.Compose, tutti gli Clock oggetti associati in precedenza a tale proprietà continuano a utilizzare le risorse di sistema. Il sistema di temporizzazione non rimuove automaticamente questi orologi.

Per evitare problemi di prestazioni quando si applica un numero elevato di orologi usando Compose, è necessario rimuovere i clock di composizione dalla proprietà animata dopo il completamento. Esistono diversi modi per rimuovere un orologio:

• Per rimuovere tutti gli orologi da una proprietà, utilizzare il ApplyAnimationClock(DependencyProperty, AnimationClock) metodo o BeginAnimation(DependencyProperty, AnimationTimeline) dell'oggetto animato. Specificare la proprietà animata come primo parametro e null come seconda. In questo modo tutti gli orologi di animazione verranno rimossi dalla proprietà .

• Per rimuovere un oggetto specifico AnimationClock da un elenco di orologi, utilizzare la Controller proprietà di AnimationClock per recuperare un ClockControlleroggetto , quindi chiamare il Remove metodo dell'oggetto ClockController. Questa operazione viene in genere eseguita nel Completed gestore eventi per un orologio. Si noti che solo gli orologi radice possono essere controllati da un oggetto ClockController. La Controller proprietà di un orologio figlio restituisce null. Si noti anche che l'evento Completed non viene chiamato se la durata effettiva dell'orologio è per sempre. In tal caso, l'utente deve determinare quando chiamare Remove.

Si tratta principalmente di un problema per le animazioni sugli oggetti che hanno una durata prolungata. Quando un oggetto viene sottoposto a Garbage Collection, anche i relativi orologi vengono disconnessi e sottoposto a Garbage Collection.

Per altre informazioni sugli oggetti clock, vedere Cenni preliminari sul sistema di animazione e temporizzazione.