FrameworkElement.BeginStoryboard Metoda

Definicja

Rozpoczyna sekwencję akcji zawartych w podanym scenorysie.Begins the sequence of actions contained in the provided storyboard.

Przeciążenia

BeginStoryboard(Storyboard)

Rozpoczyna sekwencję akcji, które są zawarte w podanym scenorysie.Begins the sequence of actions that are contained in the provided storyboard.

BeginStoryboard(Storyboard, HandoffBehavior)

Rozpoczyna sekwencję akcji zawartych w podanym scenorysie, z opcjami określonymi dla tego, co powinno się zdarzyć, jeśli właściwość jest już animowana.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)

Rozpoczyna sekwencję akcji zawartych w podanym scenorysie z określonym stanem kontroli animacji po jej uruchomieniu.Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

BeginStoryboard(Storyboard)

Rozpoczyna sekwencję akcji, które są zawarte w podanym scenorysie.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
Public Sub BeginStoryboard (storyboard As Storyboard)

Parametry

storyboard
Storyboard

Seria ujęć do rozpoczęcia.The storyboard to begin.

Przykłady

Poniższy przykład pobiera Storyboard z zasobów, a następnie uruchamia, Storyboard gdy zdarzenie wewnętrzne jest obsługiwane przez klasę.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

Uwagi

W większości typowych scenariuszy animacji nie jest używana ta metoda.Most typical animation scenarios do not use this method. Zazwyczaj tworzysz Storyboard BeginStoryboard element lub w znacznikach, a następnie umieścisz je jako EventTrigger zawartość elementu.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Gdy zdarzenie zostanie wyzwolone, animacja zostanie uruchomiona.When triggered by the event, the animation then runs. Większość aspektów kontroli Storyboard można rozmieścić według właściwości, które są widoczne w znacznikach.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

W przypadku podpisów, które nie używają isControllable parametru, lub gdy ten parametr jest określony false , zegary osi czasu skojarzone z animacją są usuwane zaraz po osiągnięciu przez animację okresu "Fill".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. W związku z tym nie można uruchomić ponownie animacji po uruchomieniu.Therefore the animation cannot be restarted after running once. Kontrolowanie animacji wymaga również, aby scenorys miał dyrektywę x:Name lub uzyskać dostęp za pomocą odwołania w kodzie.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Dotyczy

BeginStoryboard(Storyboard, HandoffBehavior)

Rozpoczyna sekwencję akcji zawartych w podanym scenorysie, z opcjami określonymi dla tego, co powinno się zdarzyć, jeśli właściwość jest już animowana.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
Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)

Parametry

storyboard
Storyboard

Seria ujęć do rozpoczęcia.The storyboard to begin.

handoffBehavior
HandoffBehavior

Wartość wyliczenia opisująca zachowanie, jeśli właściwość opisana w scenorysie jest już animowana.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

Przykłady

Poniższy przykład pobiera Storyboard z zasobów, a następnie uruchamia, Storyboard gdy zdarzenie wewnętrzne jest obsługiwane przez klasę.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

Uwagi

W większości typowych scenariuszy animacji nie jest używana ta metoda.Most typical animation scenarios do not use this method. Zazwyczaj tworzysz Storyboard BeginStoryboard element lub w znacznikach, a następnie umieścisz je jako EventTrigger zawartość elementu.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Gdy zdarzenie zostanie wyzwolone, animacja zostanie uruchomiona.When triggered by the event, the animation then runs. Większość aspektów kontroli Storyboard można rozmieścić według właściwości, które są widoczne w znacznikach.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

W przypadku podpisów, które nie używają isControllable parametru, lub gdy ten parametr jest określony false , zegary osi czasu skojarzone z animacją są usuwane zaraz po osiągnięciu przez animację okresu "Fill".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. W związku z tym nie można uruchomić ponownie animacji po uruchomieniu.Therefore the animation cannot be restarted after running once. Kontrolowanie animacji wymaga również, aby scenorys miał dyrektywę x:Name lub uzyskać dostęp za pomocą odwołania w kodzie.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Zachowanie oddania można określić jako atrybut BeginStoryboard .Handoff behavior can be specified as an attribute of BeginStoryboard.

Korzystanie z Compose HandoffBehaviorUsing the Compose HandoffBehavior

Po zastosowaniu Storyboard , AnimationTimeline , lub AnimationClock do właściwości przy użyciu Compose HandoffBehavior , wszystkie Clock obiekty wcześniej skojarzone z tą właściwością nadal zużywają zasoby systemowe; system chronometrażu nie usuwa automatycznie zegarów.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.

Aby uniknąć problemów z wydajnością w przypadku stosowania dużej liczby zegarów przy użyciu programu Compose , należy usunąć z właściwości animowane zegary, po ich zakończeniu.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. Istnieje kilka sposobów usunięcia zegara:There are several ways to remove a clock:

Jest to szczególnie problem w przypadku animacji na obiektach, które mają długi okres istnienia.This is primarily an issue for animations on objects that have a long lifetime. Gdy obiekt jest odzyskiwany, jego zegary również są rozłączone i odzyskiwane.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Aby uzyskać więcej informacji na temat obiektów zegara, zobacz animacje i system chronometrażu — przegląd.For more information about clock objects, see Animation and Timing System Overview.

Dotyczy

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Rozpoczyna sekwencję akcji zawartych w podanym scenorysie z określonym stanem kontroli animacji po jej uruchomieniu.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
Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)

Parametry

storyboard
Storyboard

Seria ujęć do rozpoczęcia.The storyboard to begin.

handoffBehavior
HandoffBehavior

Wartość wyliczenia opisująca zachowanie, jeśli właściwość opisana w scenorysie jest już animowana.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean

Deklaruje, czy animacja jest sterowana (może zostać wstrzymana) po jej uruchomieniu.Declares whether the animation is controllable (can be paused) after it is started.

Uwagi

W większości typowych scenariuszy animacji nie jest używana ta metoda.Most typical animation scenarios do not use this method. Zazwyczaj tworzysz Storyboard BeginStoryboard element lub w znacznikach, a następnie umieścisz je jako EventTrigger zawartość elementu.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Gdy zdarzenie zostanie wyzwolone, animacja zostanie uruchomiona.When triggered by the event, the animation then runs. Większość aspektów kontroli Storyboard można rozmieścić według właściwości, które są widoczne w znacznikach.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

W przypadku podpisów, które nie używają isControllable parametru, lub gdy ten parametr jest określony false , zegary osi czasu skojarzone z animacją są usuwane zaraz po osiągnięciu przez animację okresu "Fill".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. W związku z tym nie można uruchomić ponownie animacji po uruchomieniu.Therefore the animation cannot be restarted after running once. Kontrolowanie animacji wymaga również, aby scenorys miał dyrektywę x:Name lub uzyskać dostęp za pomocą odwołania w kodzie.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Zachowanie oddania można określić jako atrybut BeginStoryboard .Handoff behavior can be specified as an attribute of BeginStoryboard.

Korzystanie z Compose HandoffBehaviorUsing the Compose HandoffBehavior

Po zastosowaniu Storyboard , AnimationTimeline , lub AnimationClock do właściwości przy użyciu Compose HandoffBehavior , wszystkie Clock obiekty wcześniej skojarzone z tą właściwością nadal zużywają zasoby systemowe; system chronometrażu nie usuwa automatycznie zegarów.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.

Aby uniknąć problemów z wydajnością w przypadku stosowania dużej liczby zegarów przy użyciu programu Compose , należy usunąć z właściwości animowane zegary, po ich zakończeniu.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. Istnieje kilka sposobów usunięcia zegara:There are several ways to remove a clock:

Jest to szczególnie problem w przypadku animacji na obiektach, które mają długi okres istnienia.This is primarily an issue for animations on objects that have a long lifetime. Gdy obiekt jest odzyskiwany, jego zegary również są rozłączone i odzyskiwane.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Aby uzyskać więcej informacji na temat obiektów zegara, zobacz animacje i system chronometrażu — przegląd.For more information about clock objects, see Animation and Timing System Overview.

Dotyczy