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.
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist.
Überlädt
BeginStoryboard(Storyboard) |
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist. |
BeginStoryboard(Storyboard, HandoffBehavior) |
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist. Die angegebenen Optionen legen fest, welche Aktion ausgeführt werden soll, wenn die Eigenschaft bereits animiert ist. |
BeginStoryboard(Storyboard, HandoffBehavior, Boolean) |
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist, im angegebenen Zustand für das Steuerelement der Animation nach deren Start. |
BeginStoryboard(Storyboard)
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist.
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 -> unit
Public Sub BeginStoryboard (storyboard As Storyboard)
Parameter
- storyboard
- Storyboard
Das zu startende Storyboard.
Hinweise
Für die Signaturen, die nicht den isControllable
Parameter verwenden, oder wenn dieser Parameter angegeben false
wird, werden die Zeitleiste Uhren entfernt, die der Animation zugeordnet sind, sobald sie den Füllzeitraum erreicht. Daher kann die Animation nicht neu gestartet werden, nachdem sie einmal ausgeführt wurde. Beachten Sie, dass für die Steuerung einer Animation auch der Name oder der Zugriff auf das Storyboard als instance im Code erforderlich ist.
Gilt für:
BeginStoryboard(Storyboard, HandoffBehavior)
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist. Die angegebenen Optionen legen fest, welche Aktion ausgeführt werden soll, 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 -> unit
Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)
Parameter
- storyboard
- Storyboard
Das zu startende Storyboard.
- handoffBehavior
- HandoffBehavior
Ein Wert der Enumeration zum Beschreiben der auszuführenden Aktion, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.
Hinweise
Für die Signaturen, die nicht den isControllable
Parameter verwenden, oder wenn dieser Parameter angegeben false
wird, werden die Zeitleiste Uhren entfernt, die der Animation zugeordnet sind, sobald sie den Füllzeitraum erreicht. Daher kann die Animation nicht neu gestartet werden, nachdem sie einmal ausgeführt wurde. Beachten Sie, dass für die Steuerung einer Animation auch der Name oder der Zugriff auf das Storyboard als instance im Code erforderlich ist.
Verwenden des Verfassens von HandoffBehavior
Wenn Sie eine Storyboard- oder AnimationTimelineAnimationClock - Eigenschaft mithilfe von anwenden, verbrauchen alle Clock Objekte, die ComposeHandoffBehaviorzuvor dieser Eigenschaft zugeordnet waren, weiterhin Systemressourcen. Das Zeitsteuerungssystem entfernt die Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe Composevon anwenden, sollten Sie das Komponieren von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen sind. 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. Dadurch werden alle Animationsuhren aus der -Eigenschaft entfernt.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 Stammuhren von einem ClockControllergesteuert werden können. Die Controller -Eigenschaft einer untergeordneten Uhr gibt zurück
null
. 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 festlegen, wann aufgerufen werden soll Remove.
Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben. Wenn ein Objekt mit Müll gesammelt wird, werden auch seine Uhren getrennt und Müll gesammelt.
Weitere Informationen zu Uhr-Objekten finden Sie unter Übersicht über das Animations- und Zeitsteuerungssystem.
Gilt für:
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)
Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist, im angegebenen Zustand für das Steuerelement der Animation nach deren Start.
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 -> unit
Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)
Parameter
- storyboard
- Storyboard
Das zu startende Storyboard.
- handoffBehavior
- HandoffBehavior
Ein Wert der Enumeration zum Beschreiben der auszuführenden Aktion, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.
- isControllable
- Boolean
Bestimmt, ob die Animation steuerbar ist (angehalten werden kann), nachdem sie gestartet wurde.
Hinweise
Für die Signaturen, die nicht den isControllable
Parameter verwenden, oder wenn dieser Parameter angegeben false
wird, werden die Zeitleiste Uhren entfernt, die der Animation zugeordnet sind, sobald sie den Füllzeitraum erreicht. Daher kann die Animation nicht neu gestartet werden, nachdem sie einmal ausgeführt wurde. Beachten Sie, dass für die Steuerung einer Animation auch der Name oder der Zugriff auf das Storyboard als instance im Code erforderlich ist.
Verwenden des Verfassens von HandoffBehavior
Wenn Sie eine Storyboard- , AnimationTimeline- oder AnimationClock -Eigenschaft mithilfe von anwenden, verbrauchen alle Clock Objekte, die ComposeHandoffBehaviorzuvor dieser Eigenschaft zugeordnet waren, weiterhin Systemressourcen. Das Zeitsteuerungssystem entfernt diese Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe Composevon anwenden, sollten Sie das Komponieren von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen sind. 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. Dadurch werden alle Animationsuhren aus der -Eigenschaft entfernt.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 Stammuhren von einem ClockControllergesteuert werden können. Die Controller -Eigenschaft einer untergeordneten Uhr gibt zurück
null
. 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 festlegen, wann aufgerufen werden soll Remove.
Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben. Wenn ein Objekt mit Müll gesammelt wird, werden auch seine Uhren getrennt und Müll gesammelt.
Weitere Informationen zu Uhr-Objekten finden Sie unter Ü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