BeginStoryboard Methode (Storyboard, HandoffBehavior, Boolean)
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

FrameworkElement.BeginStoryboard-Methode (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.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public void BeginStoryboard(
	Storyboard storyboard,
	HandoffBehavior handoffBehavior,
	bool isControllable
)

Parameter

storyboard

Das zu startende Storyboard.

handoffBehavior

Ein Wert der Enumeration zum Beschreiben der auszuführenden Aktion, wenn eine im Storyboard beschriebene Eigenschaft bereits animiert ist.

isControllable

Bestimmt, ob die Animation steuerbar ist (angehalten werden kann), nachdem sie gestartet wurde.

In den meisten Animationsszenarios wird diese Methode nicht verwendet.In der Regel erstellen Sie das Storyboard-Element oder das BeginStoryboard-Element in Markup und fügen diese Elemente anschließen als EventTrigger-Inhalt für ein Element ein.Sobald sie vom Ereignis ausgelöst wird, wird die Animation ausgeführt.Die Steuerung eines Storyboard erfolgt im Wesentlichen über Eigenschaften, die in Markup verfügbar gemacht werden.

Bei Signaturen, die den isControllable-Parameter nicht verwenden, oder wenn der Parameter als false angegeben ist, werden die der Animation zugeordneten Uhren auf der Zeitachse entfernt, sobald die Animation den Ausfüllzeitraum erreicht.Daher kann die Animation erst wieder neu gestartet werden, nachdem sie einmal vollständig ausgeführt wurde.Zum Steuern einer Animation ist es außerdem erforderlich, dass das Storyboard über ein x:Name-Direktive verfügt oder dass per Verweis aus Code auf das Storyboard zugegriffen werden kann.

Das Übergabeverhalten kann als Attribut des BeginStoryboard angegeben werden.

Wenn Sie ein Storyboard, eine AnimationTimeline oder eine AnimationClock mit dem Compose-HandoffBehavior auf eine Eigenschaft anwenden, beanspruchen Clock-Objekte, die zuvor dieser Eigenschaft zugeordnet waren, weiterhin Systemressourcen. Diese Uhren werden nicht automatisch vom Zeitsteuerungssystem entfernt.

Um Leistungsprobleme zu vermeiden, wenn Sie mithilfe von Compose eine große Anzahl von Uhren anwenden, sollten Sie zusammengesetzte Uhren aus der animierten Eigenschaft entfernen, nachdem sie ausgeführt wurden.Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen:

Dies betrifft hauptsächlich Animationen für Objekte mit einer langen Lebensdauer. Wenn ein Objekt an den Garbage Collector übergeben wird, wird auch die Verbindung der Uhren des Objekts getrennt, und diese werden ebenfalls an den Garbage Collector übergeben.

Weitere Informationen über Uhrobjekte finden Sie unter Übersicht über das Animations- und Zeitsteuerungssystem.

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen:
© 2016 Microsoft