Animatable.ApplyAnimationClock Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Animiert die angegebene DependencyProperty mit der angegebenen AnimationClock.
Überlädt
ApplyAnimationClock(DependencyProperty, AnimationClock) |
Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. |
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. |
ApplyAnimationClock(DependencyProperty, AnimationClock)
Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet.
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)
Parameter
Die zu animierende Eigenschaft.
- clock
- AnimationClock
Der Takt, mit dem die angegebene Eigenschaft animiert werden soll. Wenn clock
gleich null
ist, werden alle Animationen aus der angegebenen Eigenschaft entfernt (jedoch nicht angehalten).
Implementiert
Hinweise
Beachten Sie, dass die Verwendung dieser Methode zum Entfernen von Uhren aus einer Eigenschaft diese Uhren nicht beendet.
Gilt für:
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)
Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet.
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)
Parameter
Die zu animierende Eigenschaft.
- clock
- AnimationClock
Der Takt, mit dem die angegebene Eigenschaft animiert werden soll. Wenn handoffBehavior
den Wert SnapshotAndReplace aufweist und clock
null
ist, werden alle Animationen aus der angegebenen Eigenschaft entfernt (jedoch nicht angehalten). Wenn für handoffBehavior
der Wert Compose festgelegt ist und clock null
ist, hat diese Methode keine Auswirkungen.
- handoffBehavior
- HandoffBehavior
Ein Wert, der angibt, wie die neue Animation ggf. mit aktuellen Animationen interagieren soll, die sich bereits auf den Eigenschaftswert auswirken.
Implementiert
Beispiele
Das folgende Beispiel zeigt, wie Sie Animationsuhren mit unterschiedlichen HandoffBehavior Einstellungen anwenden.
Hinweise
Beachten Sie, dass die Verwendung dieser Methode zum Entfernen von Uhren aus einer Eigenschaft diese Uhren nicht beendet.
Verwenden des Verfassens von HandoffBehavior
Wenn Sie eine Storyboard, AnimationTimeline, oder AnimationClock auf eine Eigenschaft die ComposeHandoffBehavior anwenden, verbrauchen alle Clock-Objekte, die zuvor mit dieser Eigenschaft verknüpft waren, weiterhin Systemressourcen; das Timing-System wird diese Uhren nicht automatisch entfernen.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von Compose anwenden, sollten Sie zusammengesetzte Uhren, nachdem sie ausgeführt wurden, aus der animierten Eigenschaft entfernen. Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen.
Um alle Uhren aus einer Eigenschaft zu entfernen, verwenden Sie die ApplyAnimationClock(DependencyProperty, AnimationClock)- oder BeginAnimation(DependencyProperty, AnimationTimeline)-Methode des animierten Objekts. Geben Sie die zu animierende Eigenschaft als ersten Parameter und
null
als zweiten an. Dies entfernt alle Animationsuhren aus der Eigenschaft.Um eine bestimmte AnimationClock-Liste von Uhren zu entfernen, verwenden Sie die Eigenschaft Controller von AnimationClock um eine ClockController abzurufen, und rufen Sie dann die Remove-Methode der ClockController auf. Dies geschieht in der Regel im Completed-Ereignishandler für eine Uhr. Beachten Sie, dass nur Root-Uhren von einem ClockController gesteuert werden können; die Controller-Eigenschaft einer untergeordneten Uhr gibt
null
aus. Beachten Sie auch, dass das Completed-Ereignis nicht aufgerufen wird, wenn die effektive Dauer der Uhr endlos ist. In diesem Fall muss der Benutzer selbst bestimmen, wann er Remove aufruft.
Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben. Wenn ein Objekt an den Garbage Collector übergeben wird, werden auch die Uhren getrennt und an den Garbage Collector übergeben.
Weitere Informationen zu Uhrobjekten finden Sie in der Übersicht über das Animations- und Zeitsteuerungssystem.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für