Animatable.ApplyAnimationClock Metodo

Definizione

Spazio dei nomi:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Aggiunge un'animazione al DependencyProperty specificato utilizzando il AnimationClockspecificato.

Overload

ApplyAnimationClock(DependencyProperty, AnimationClock)	Applica un AnimationClock all'DependencyPropertyspecificato. Se la proprietà è già animata, viene utilizzato il comportamento di handoff SnapshotAndReplace.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applica un AnimationClock all'DependencyPropertyspecificato. Se la proprietà è già animata, viene utilizzata la HandoffBehavior specificata.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Applica un AnimationClock all'DependencyPropertyspecificato. Se la proprietà è già animata, viene utilizzato il comportamento di handoff SnapshotAndReplace.

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)

Parametri

dp

DependencyProperty

Proprietà da animare.

clock

AnimationClock

Orologio con cui animare la proprietà specificata. Se clock è null, tutte le animazioni verranno rimosse dalla proprietà specificata (ma non arrestate).

Implementazioni

ApplyAnimationClock(DependencyProperty, AnimationClock)

Commenti

Si noti che l'uso di questo metodo per rimuovere gli orologi da una proprietà non arresta tali orologi.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applica un AnimationClock all'DependencyPropertyspecificato. Se la proprietà è già animata, viene utilizzata la HandoffBehavior specificata.

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

Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock, handoffBehavior As HandoffBehavior)

Parametri

dp

DependencyProperty

Proprietà da animare.

clock

AnimationClock

Orologio con cui animare la proprietà specificata. Se handoffBehavior è SnapshotAndReplace e clock è null, tutte le animazioni verranno rimosse dalla proprietà specificata (ma non arrestate). Se handoffBehavior è Compose e l'orologio è null, questo metodo non ha alcun effetto.

handoffBehavior

HandoffBehavior

Valore che specifica il modo in cui la nuova animazione deve interagire con qualsiasi animazione corrente che influisce già sul valore della proprietà.

Implementazioni

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Esempio

Nell'esempio seguente viene illustrato come applicare orologi di animazione usando impostazioni di HandoffBehavior diverse.

Commenti

Si noti che l'uso di questo metodo per rimuovere gli orologi da una proprietà non arresta tali orologi.

Uso di Compose HandoffBehavior

Quando si applica un Storyboard, AnimationTimelineo AnimationClock a una proprietà utilizzando l'ComposeHandoffBehavior, tutti gli oggetti Clock precedentemente associati a tale proprietà continuano a utilizzare le risorse di sistema; il sistema di temporizzazione non rimuoverà 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 metodo ApplyAnimationClock(DependencyProperty, AnimationClock) 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 AnimationClock specifico da un elenco di orologi, utilizzare la proprietà Controller del AnimationClock per recuperare un ClockController, quindi chiamare il metodo Remove del ClockController. Questa operazione viene in genere eseguita nel gestore eventi Completed per un orologio. Si noti che solo gli orologi radice possono essere controllati da un ClockController; la proprietà Controller di un orologio figlio restituirà null. Si noti anche che l'evento Completed non verrà chiamato se la durata effettiva dell'orologio è per sempre. In tal caso, l'utente dovrà 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 verranno disconnessi e il Garbage Collection.

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