FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard FrameworkElement.BeginStoryboard Method

Definition

Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist.Begins the sequence of actions contained in the provided storyboard.

Überlädt

BeginStoryboard(Storyboard) BeginStoryboard(Storyboard) BeginStoryboard(Storyboard)

Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist.Begins the sequence of actions that are contained in the provided storyboard.

BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior)

Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist. Dabei sind Optionen angegeben, welche Aktion ausgeführt werden soll, wenn die Eigenschaft bereits animiert ist.Begins the sequence of actions contained in the provided storyboard, with options specified for what should happen if the property is already animated.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean) 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.Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

BeginStoryboard(Storyboard) BeginStoryboard(Storyboard) BeginStoryboard(Storyboard)

Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist.Begins the sequence of actions that are contained in the provided storyboard.

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

Parameter

storyboard
Storyboard Storyboard Storyboard

Das zu startende Storyboard.The storyboard to begin.

Beispiele

Das folgende Beispiel ruft eine Storyboard aus Ressourcen, und klicken Sie dann ausgeführt wird, Storyboard Wenn ist ein internes Ereignis Klasse behandelt.The following example retrieves a Storyboard from resources, and then runs that Storyboard when an internal event is class handled.

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

Häufigste Animations-Szenarios verwenden Sie diese Methode nicht.Most typical animation scenarios do not use this method. Normalerweise erstellen Sie die Storyboard oder BeginStoryboard platzieren Sie diese als Element im Markup, und klicken Sie dann Sie die EventTrigger Inhalt für ein Element.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Wenn das Ereignis ausgelöst wird, wird die Animation dann ausgeführt.When triggered by the event, the animation then runs. Die meisten der die Kontrolle einiger Aspekte einer Storyboard gelöst werden, indem die Eigenschaften, die im Markup verfügbar gemacht werden.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

Für die Signaturen, die keine verwenden die isControllable, Parameter, oder wenn dieser Parameter angegeben wird false, Uhren auf der Zeitachse, die die Animation zugeordnet sind werden entfernt, sobald die Animation den "Fill"-Zeitraum erreicht.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. Aus diesem Grund kann nicht die Animation neu gestartet werden, nachdem Sie einmal ausgeführt.Therefore the animation cannot be restarted after running once. Steuern einer Animation erfordert auch, dass das Storyboard haben eine X: Name Directive oder darauf verweisen im Code zugreifen können.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior) BeginStoryboard(Storyboard, HandoffBehavior)

Startet die Sequenz von Aktionen, die im bereitgestellten Storyboard enthalten ist. Dabei sind Optionen angegeben, welche Aktion ausgeführt werden soll, wenn die Eigenschaft bereits animiert ist.Begins the sequence of actions contained in the provided storyboard, with options specified for what should happen if the property is already animated.

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

Parameter

storyboard
Storyboard Storyboard Storyboard

Das zu startende Storyboard.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Ein Wert der Enumeration zum Beschreiben der auszuführenden Aktion, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

Beispiele

Das folgende Beispiel ruft eine Storyboard aus Ressourcen, und klicken Sie dann ausgeführt wird, Storyboard Wenn ist ein internes Ereignis Klasse behandelt.The following example retrieves a Storyboard from resources, and then runs that Storyboard when an internal event is class handled.

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

Häufigste Animations-Szenarios verwenden Sie diese Methode nicht.Most typical animation scenarios do not use this method. Normalerweise erstellen Sie die Storyboard oder BeginStoryboard platzieren Sie diese als Element im Markup, und klicken Sie dann Sie die EventTrigger Inhalt für ein Element.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Wenn das Ereignis ausgelöst wird, wird die Animation dann ausgeführt.When triggered by the event, the animation then runs. Die meisten der die Kontrolle einiger Aspekte einer Storyboard gelöst werden, indem die Eigenschaften, die im Markup verfügbar gemacht werden.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

Für die Signaturen, die keine verwenden die isControllable, Parameter, oder wenn dieser Parameter angegeben wird false, Uhren auf der Zeitachse, die die Animation zugeordnet sind werden entfernt, sobald die Animation den "Fill"-Zeitraum erreicht.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. Aus diesem Grund kann nicht die Animation neu gestartet werden, nachdem Sie einmal ausgeführt.Therefore the animation cannot be restarted after running once. Steuern einer Animation erfordert auch, dass das Storyboard haben eine X: Name Directive oder darauf verweisen im Code zugreifen können.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Übergabeverhalten kann angegeben werden, als ein Attribut des BeginStoryboard.Handoff behavior can be specified as an attribute of BeginStoryboard.

Mithilfe der Compose HandoffBehaviorUsing the Compose HandoffBehavior

Beim Anwenden einer Storyboard, AnimationTimeline, oder AnimationClock auf eine Eigenschaft mit der Compose HandoffBehavior, Clock Objekte, die diese Eigenschaft zuvor zugeordnet waren weiterhin Systemressourcen beanspruchen, ist das Zeitsteuerungssystem die Uhren nicht automatisch entfernt werden.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von anwenden Compose, sollten Sie zusammengesetzte Uhren aus der animierten Eigenschaft entfernen, nachdem sie ausgeführt.To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen:There are several ways to remove a clock:

Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben.This is primarily an issue for animations on objects that have a long lifetime. Wenn ein Objekt Garbage Collection durchgeführt wird, werden auch die Uhren getrennt. und Garbage collection.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Weitere Informationen zu uhrobjekten finden Sie unter Animation und zeitliche Steuerung Systemübersicht.For more information about clock objects, see Animation and Timing System Overview.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean) BeginStoryboard(Storyboard, HandoffBehavior, Boolean) 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.Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

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

Parameter

storyboard
Storyboard Storyboard Storyboard

Das zu startende Storyboard.The storyboard to begin.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior

Ein Wert der Enumeration zum Beschreiben der auszuführenden Aktion, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean Boolean Boolean

Bestimmt, ob die Animation steuerbar ist (angehalten werden kann), nachdem sie gestartet wurde.Declares whether the animation is controllable (can be paused) after it is started.

Hinweise

Häufigste Animations-Szenarios verwenden Sie diese Methode nicht.Most typical animation scenarios do not use this method. Normalerweise erstellen Sie die Storyboard oder BeginStoryboard platzieren Sie diese als Element im Markup, und klicken Sie dann Sie die EventTrigger Inhalt für ein Element.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Wenn das Ereignis ausgelöst wird, wird die Animation dann ausgeführt.When triggered by the event, the animation then runs. Die meisten der die Kontrolle einiger Aspekte einer Storyboard gelöst werden, indem die Eigenschaften, die im Markup verfügbar gemacht werden.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

Für die Signaturen, die keine verwenden die isControllable, Parameter, oder wenn dieser Parameter angegeben wird false, Uhren auf der Zeitachse, die die Animation zugeordnet sind werden entfernt, sobald die Animation den "Fill"-Zeitraum erreicht.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks that are associated with the animation are removed as soon as the animation reaches the "Fill" period. Aus diesem Grund kann nicht die Animation neu gestartet werden, nachdem Sie einmal ausgeführt.Therefore the animation cannot be restarted after running once. Steuern einer Animation erfordert auch, dass das Storyboard haben eine X: Name Directive oder darauf verweisen im Code zugreifen können.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Übergabeverhalten kann angegeben werden, als ein Attribut des BeginStoryboard.Handoff behavior can be specified as an attribute of BeginStoryboard.

Mithilfe der Compose HandoffBehaviorUsing the Compose HandoffBehavior

Beim Anwenden einer Storyboard, AnimationTimeline, oder AnimationClock auf eine Eigenschaft mit der Compose HandoffBehavior, Clock Objekte, die diese Eigenschaft zuvor zugeordnet waren weiterhin Systemressourcen beanspruchen, ist das Zeitsteuerungssystem die Uhren nicht automatisch entfernt werden.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von anwenden Compose, sollten Sie zusammengesetzte Uhren aus der animierten Eigenschaft entfernen, nachdem sie ausgeführt.To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen:There are several ways to remove a clock:

Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben.This is primarily an issue for animations on objects that have a long lifetime. Wenn ein Objekt Garbage Collection durchgeführt wird, werden auch die Uhren getrennt. und Garbage collection.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Weitere Informationen zu uhrobjekten finden Sie unter Animation und zeitliche Steuerung Systemübersicht.For more information about clock objects, see Animation and Timing System Overview.

Gilt für: