FrameworkElement.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
| Name | Beschreibung |
|---|---|
| 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 sind, was passieren soll, 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.
Beispiele
Im folgenden Beispiel wird eine Storyboard aus Ressourcen abgerufen und anschließend ausgeführt Storyboard , wenn ein internes Ereignis klassenhandhabt wird.
private void OnImage1Animate(object sender, RoutedEventArgs e)
{
Storyboard s;
s = (Storyboard)this.FindResource("RotateStoryboard");
this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
Dim s As Storyboard
s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
Me.BeginStoryboard(s)
End Sub
Hinweise
Die meisten typischen Animationsszenarien verwenden diese Methode nicht. In der Regel erstellen Sie das Storyboard Element BeginStoryboard im Markup, und platzieren sie dann als EventTrigger Inhalt in einem Element. Wenn die Animation durch das Ereignis ausgelöst wird, wird die Animation ausgeführt. Die meisten Steuerelementaspekte eines Steuerelements Storyboard können durch Eigenschaften behoben werden, die im Markup verfügbar gemacht werden.
Bei den Signaturen, die den isControllableParameter nicht verwenden oder wenn dieser Parameter angegeben falsewird, werden die Zeitachsenuhren, die der Animation zugeordnet sind, entfernt, sobald die Animation den Punkt "Füllung" erreicht. Daher kann die Animation nach der Ausführung nicht einmal neu gestartet werden. Die Steuerung einer Animation erfordert auch, dass das Storyboard über eine x:Name-Direktive verfügt oder über einen Verweis im Code zugänglich ist.
Gilt für:
BeginStoryboard(Storyboard, HandoffBehavior)
Beginnt die Abfolge von Aktionen, die im bereitgestellten Storyboard enthalten sind, mit Optionen, die angegeben sind, was passieren 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 -> 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.
Beispiele
Im folgenden Beispiel wird eine Storyboard aus Ressourcen abgerufen und anschließend ausgeführt Storyboard , wenn ein internes Ereignis klassenhandhabt wird.
private void OnImage1Animate(object sender, RoutedEventArgs e)
{
Storyboard s;
s = (Storyboard)this.FindResource("RotateStoryboard");
this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
Dim s As Storyboard
s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
Me.BeginStoryboard(s)
End Sub
Hinweise
Die meisten typischen Animationsszenarien verwenden diese Methode nicht. In der Regel erstellen Sie das Storyboard Element BeginStoryboard im Markup, und platzieren sie dann als EventTrigger Inhalt in einem Element. Wenn die Animation durch das Ereignis ausgelöst wird, wird die Animation ausgeführt. Die meisten Steuerelementaspekte eines Steuerelements Storyboard können durch Eigenschaften behoben werden, die im Markup verfügbar gemacht werden.
Bei den Signaturen, die den isControllableParameter nicht verwenden oder wenn dieser Parameter angegeben falsewird, werden die Zeitachsenuhren, die der Animation zugeordnet sind, entfernt, sobald die Animation den Punkt "Füllung" erreicht. Daher kann die Animation nach der Ausführung nicht einmal neu gestartet werden. Die Steuerung einer Animation erfordert auch, dass das Storyboard über eine x:Name-Direktive verfügt oder über einen Verweis im Code zugänglich ist.
Das Handoffverhalten kann als Attribut von BeginStoryboardangegeben werden.
Verwenden des VerfassenhandoffBehavior
Wenn Sie ein Storyboard, AnimationTimelineoder AnimationClock eine Eigenschaft mithilfe der Eigenschaft anwenden, werden alle Clock objekte, dieHandoffBehaviorCompose dieser Eigenschaft zuvor zugeordnet waren, weiterhin Systemressourcen verbrauchen. Das Timing-System entfernt die Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von ComposeUhr anwenden, sollten Sie das Verfassen von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen wurden. Es gibt mehrere Möglichkeiten zum Entfernen einer Uhr:
Wenn Sie alle Uhren aus einer Eigenschaft entfernen möchten, verwenden Sie die methode oder BeginAnimation(DependencyProperty, AnimationTimeline) die ApplyAnimationClock(DependencyProperty, AnimationClock) Methode des animierten Objekts. Geben Sie die Eigenschaft an, die als erster Parameter und
nullals zweite animiert wird. Dadurch werden alle Animationsuhren aus der Eigenschaft entfernt.Verwenden Sie zum Entfernen einer bestimmten AnimationClock Liste von Uhren die Controller Eigenschaft der AnimationClock zum Abrufen einer ClockController, und rufen Sie dann die Remove Methode der ClockController. Dies erfolgt in der Completed Regel im Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren von einer ClockController; die Controller Eigenschaft einer untergeordneten Uhr zurückgegeben
nullwerden kann . 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 aufgerufen werden Removesoll.
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 und 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
Die meisten typischen Animationsszenarien verwenden diese Methode nicht. In der Regel erstellen Sie das Storyboard Element BeginStoryboard im Markup, und platzieren sie dann als EventTrigger Inhalt in einem Element. Wenn die Animation durch das Ereignis ausgelöst wird, wird die Animation ausgeführt. Die meisten Steuerelementaspekte eines Steuerelements Storyboard können durch Eigenschaften behoben werden, die im Markup verfügbar gemacht werden.
Bei den Signaturen, die den isControllableParameter nicht verwenden oder wenn dieser Parameter angegeben falsewird, werden die Zeitachsenuhren, die der Animation zugeordnet sind, entfernt, sobald die Animation den Punkt "Füllung" erreicht. Daher kann die Animation nach der Ausführung nicht einmal neu gestartet werden. Die Steuerung einer Animation erfordert auch, dass das Storyboard über eine x:Name-Direktive verfügt oder über einen Verweis im Code zugänglich ist.
Das Handoffverhalten kann als Attribut von BeginStoryboardangegeben werden.
Verwenden des VerfassenhandoffBehavior
Wenn Sie ein Storyboard, AnimationTimelineoder AnimationClock eine Eigenschaft mithilfe der Eigenschaft anwenden, werden alle Clock objekte, dieHandoffBehaviorCompose dieser Eigenschaft zuvor zugeordnet waren, weiterhin Systemressourcen verbrauchen. Das Timing-System entfernt die Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von ComposeUhr anwenden, sollten Sie das Verfassen von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen wurden. Es gibt mehrere Möglichkeiten zum Entfernen einer Uhr:
Wenn Sie alle Uhren aus einer Eigenschaft entfernen möchten, verwenden Sie die methode oder BeginAnimation(DependencyProperty, AnimationTimeline) die ApplyAnimationClock(DependencyProperty, AnimationClock) Methode des animierten Objekts. Geben Sie die Eigenschaft an, die als erster Parameter und
nullals zweite animiert wird. Dadurch werden alle Animationsuhren aus der Eigenschaft entfernt.Verwenden Sie zum Entfernen einer bestimmten AnimationClock Liste von Uhren die Controller Eigenschaft der AnimationClock zum Abrufen einer ClockController, und rufen Sie dann die Remove Methode der ClockController. Dies erfolgt in der Completed Regel im Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren von einer ClockController; die Controller Eigenschaft einer untergeordneten Uhr zurückgegeben
nullwerden kann . 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 aufgerufen werden Removesoll.
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 und Timing System Overview.
