FrameworkContentElement.BeginStoryboard 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.
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind.
Überlädt
| BeginStoryboard(Storyboard) |
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind. |
| BeginStoryboard(Storyboard, HandoffBehavior) |
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind, mit Optionen, die angegeben werden sollten, wenn die Eigenschaft bereits animiert ist. |
| BeginStoryboard(Storyboard, HandoffBehavior, Boolean) |
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind, mit dem angegebenen Zustand für die Steuerung der Animation, nachdem sie gestartet wurde. |
BeginStoryboard(Storyboard)
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind.
public:
void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard);public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard);member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard -> unitPublic Sub BeginStoryboard (storyboard As Storyboard)Parameter
- storyboard
- Storyboard
Das Storyboard, das beginnen soll.
Hinweise
Für die Signaturen, die den isControllable, Parameter oder wenn dieser Parameter falseangegeben wird, werden die Zeitachsenuhren, die der Animation zugeordnet sind, entfernt, sobald sie den "Füllzeitraum" erreicht. Daher kann die Animation nach der Ausführung nicht einmal neu gestartet werden. Beachten Sie, dass die Steuerung einer Animation auch erfordert, dass das Storyboard als Instanz im Code benannt oder zugänglich ist.
Gilt für:
BeginStoryboard(Storyboard, HandoffBehavior)
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind, mit Optionen, die angegeben werden sollten, wenn die Eigenschaft bereits animiert ist.
public:
void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior -> unitPublic Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)Parameter
- storyboard
- Storyboard
Das Storyboard, das beginnen soll.
- handoffBehavior
- HandoffBehavior
Ein Wert der Aufzählung, die das Verhalten beschreibt, das verwendet werden soll, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.
Hinweise
Für die Signaturen, die den isControllable, Parameter oder wenn dieser Parameter falseangegeben wird, werden die Zeitachsenuhren, die der Animation zugeordnet sind, entfernt, sobald sie den "Füllzeitraum" erreicht. Daher kann die Animation nach der Ausführung nicht einmal neu gestartet werden. Beachten Sie, dass die Steuerung einer Animation auch erfordert, dass das Storyboard als Instanz im Code benannt oder zugänglich ist.
Verwenden des VerfassenhandoffBehavior
Wenn Sie eine Storyboard, AnimationTimelineoder AnimationClock auf eine Eigenschaft anwenden, indem Sie die ComposeHandoffBehaviorverwenden, verwenden alle zuvor dieser Eigenschaft zugeordneten Clock Objekte weiterhin Systemressourcen; Das Timing-System entfernt die Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von Composeanwenden, sollten Sie das Verfassen von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen wurden. Es gibt mehrere Möglichkeiten zum Entfernen einer Uhr:
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 Eigenschaft an, die als erster Parameter animiert wird, und
nullals zweite. Dadurch werden alle Animationsuhren aus der Eigenschaft entfernt.Um eine bestimmte AnimationClock aus einer Liste von Uhren zu entfernen, verwenden Sie die Controller-Eigenschaft des AnimationClock, um eine ClockControllerabzurufen, und rufen Sie dann die Remove Methode der ClockControllerauf. Dies erfolgt in der Regel im Completed Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren durch eine ClockControllergesteuert werden können; die Controller Eigenschaft einer untergeordneten Uhr gibt
nullzurück. Beachten Sie auch, dass das Completed-Ereignis nicht ausgelöst wird, wenn die effektive Dauer der Uhr für immer ist. In diesem Fall muss der Benutzer bestimmen, wann Removeaufgerufen werden soll.
Dies ist in erster Linie ein Problem bei Animationen für Objekte, die eine lange Lebensdauer aufweisen. Wenn ein Objekt garbage collection wird, werden die Uhren ebenfalls getrennt und garbage collection.
Weitere Informationen zu Uhrobjekten finden Sie unter Animation and Timing System Overview.
Gilt für:
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind, mit dem angegebenen Zustand für die Steuerung der Animation, nachdem sie gestartet wurde.
public:
void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior, bool isControllable);public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior, bool isControllable);member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior * bool -> unitPublic Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)Parameter
- storyboard
- Storyboard
Das Storyboard, das beginnen soll.
- handoffBehavior
- HandoffBehavior
Ein Wert der Aufzählung, die das Verhalten beschreibt, das verwendet werden soll, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.
- isControllable
- Boolean
Deklariert, ob die Animation gesteuert werden kann (kann angehalten werden), nachdem sie gestartet wurde.
Hinweise
Für die Signaturen, die den isControllable, Parameter oder wenn dieser Parameter falseangegeben wird, werden die Zeitachsenuhren, die der Animation zugeordnet sind, entfernt, sobald sie den "Füllzeitraum" erreicht. Daher kann die Animation nach der Ausführung nicht einmal neu gestartet werden. Beachten Sie, dass die Steuerung einer Animation auch erfordert, dass das Storyboard als Instanz im Code benannt oder zugänglich ist.
Verwenden des VerfassenhandoffBehavior
Wenn Sie eine Storyboard, AnimationTimelineoder AnimationClock auf eine Eigenschaft anwenden, indem Sie die ComposeHandoffBehaviorverwenden, verwenden alle zuvor dieser Eigenschaft zugeordneten Clock Objekte weiterhin Systemressourcen; Das Timing-System entfernt diese Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von Composeanwenden, sollten Sie das Verfassen von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen wurden. Es gibt mehrere Möglichkeiten zum Entfernen einer Uhr:
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 Eigenschaft an, die als erster Parameter animiert wird, und
nullals zweite. Dadurch werden alle Animationsuhren aus der Eigenschaft entfernt.Um eine bestimmte AnimationClock aus einer Liste von Uhren zu entfernen, verwenden Sie die Controller-Eigenschaft des AnimationClock, um eine ClockControllerabzurufen, und rufen Sie dann die Remove Methode der ClockControllerauf. Dies erfolgt in der Regel im Completed Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren durch eine ClockControllergesteuert werden können; die Controller Eigenschaft einer untergeordneten Uhr gibt
nullzurück. Beachten Sie auch, dass das Completed-Ereignis nicht ausgelöst wird, wenn die effektive Dauer der Uhr für immer ist. In diesem Fall muss der Benutzer bestimmen, wann Removeaufgerufen werden soll.
Dies ist in erster Linie ein Problem bei Animationen für Objekte, die eine lange Lebensdauer aufweisen. Wenn ein Objekt garbage collection wird, werden die Uhren ebenfalls getrennt und garbage collection.
Weitere Informationen zu Uhrobjekten finden Sie unter Animation and Timing System Overview.
