FrameworkContentElement.BeginStoryboard Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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 isControllableParameter verwenden, oder wenn dieser Parameter angegeben falsewird, 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.

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 isControllableParameter verwenden, oder wenn dieser Parameter angegeben falsewird, 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.

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 isControllableParameter verwenden, oder wenn dieser Parameter angegeben falsewird, 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.