BeginStoryboard.HandoffBehavior Proprietà

Definizione

Spazio dei nomi:

System.Windows.Media.Animation

Assembly:

PresentationFramework.dll

Ottiene o imposta il comportamento di distribuzione corretto per avviare un orologio dell'animazione in questo storyboard.

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à

HandoffBehavior

Uno dei valori dell'enumerazione HandoffBehavior. Il valore predefinito è SnapshotAndReplace.

Commenti

Uso di Compose HandoffBehavior

Quando si applica una proprietà , o AnimationClock a una Storyboardproprietà usando HandoffBehavior.Compose, AnimationTimelinetutti 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 orologi di composizione dalla proprietà animata dopo il completamento. Esistono diversi modi per rimuovere un orologio:

• Per rimuovere tutti gli orologi da una proprietà, usare 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 dell'animazione vengono rimossi dalla proprietà.

• Per rimuovere un oggetto specifico AnimationClock da un elenco di orologi, utilizzare la Controller proprietà dell'oggetto AnimationClockClockControllerper recuperare un ClockControlleroggetto , quindi chiamare il Remove metodo di . 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 . La Controller proprietà di un ClockControllerorologio figlio restituisce null. Si noti anche che l'evento non viene chiamato se la durata effettiva dell'orologio Completed è per sempre. In tal caso, l'utente deve determinare quando chiamare Remove.

Si tratta principalmente di un problema relativo alle animazioni su oggetti di lunga durata. Quando un oggetto viene garbage collection, i relativi orologi vengono disconnessi e garbage collection.

Per altre informazioni sugli oggetti orologio, vedere Panoramica del sistema di animazione e temporizzazione.