FrameworkElement.BeginStoryboard Metoda

Definice

Zahájí sekvenci akcí obsažených v zadaném scénáři.Begins the sequence of actions contained in the provided storyboard.

Přetížení

BeginStoryboard(Storyboard)

Zahájí sekvenci akcí, které jsou obsaženy v poskytnutém scénáři.Begins the sequence of actions that are contained in the provided storyboard.

BeginStoryboard(Storyboard, HandoffBehavior)

Zahájí sekvenci akcí obsažených v poskytnutém scénáři s možnostmi určenými pro to, co se má stát, pokud je vlastnost již animovaná.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)

Zahájí sekvenci akcí obsažených v poskytnutém scénáři se zadaným stavem pro kontrolu animace po jejím spuštění.Begins the sequence of actions contained in the provided storyboard, with specified state for control of the animation after it is started.

BeginStoryboard(Storyboard)

Zahájí sekvenci akcí, které jsou obsaženy v poskytnutém scénáři.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

Scénář, který má začít.The storyboard to begin.

Příklady

Následující příklad načte Storyboard z prostředků a potom spustí, Storyboard když je interní událost zpracována třídou.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

Poznámky

Většina typických scénářů animace tuto metodu nepoužívá.Most typical animation scenarios do not use this method. Obvykle můžete vytvořit Storyboard BeginStoryboard prvek nebo v kódu a pak je umístit jako EventTrigger obsah elementu.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Když událost aktivuje, animace se pak spustí.When triggered by the event, the animation then runs. Většinu aspektů ovládacího prvku Storyboard lze adresovat vlastnostmi, které jsou zpřístupněny v označení.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

Pro signatury, které nepoužívají isControllable parametr, nebo je-li tento parametr zadán false , jsou hodiny časové osy, které jsou přidruženy k animaci, odebrány, jakmile animace dosáhne tečky "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. Proto po spuštění nemůže být animace restartována.Therefore the animation cannot be restarted after running once. Řízení animace také vyžaduje, aby scénář měl direktivu x:Name nebo aby byl přístupný odkazem v kódu.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Platí pro

BeginStoryboard(Storyboard, HandoffBehavior)

Zahájí sekvenci akcí obsažených v poskytnutém scénáři s možnostmi určenými pro to, co se má stát, pokud je vlastnost již animovaná.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

Scénář, který má začít.The storyboard to begin.

handoffBehavior
HandoffBehavior

Hodnota výčtu, která popisuje chování pro použití v případě, že je již animována vlastnost popsaná ve scénáři.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

Příklady

Následující příklad načte Storyboard z prostředků a potom spustí, Storyboard když je interní událost zpracována třídou.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

Poznámky

Většina typických scénářů animace tuto metodu nepoužívá.Most typical animation scenarios do not use this method. Obvykle můžete vytvořit Storyboard BeginStoryboard prvek nebo v kódu a pak je umístit jako EventTrigger obsah elementu.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Když událost aktivuje, animace se pak spustí.When triggered by the event, the animation then runs. Většinu aspektů ovládacího prvku Storyboard lze adresovat vlastnostmi, které jsou zpřístupněny v označení.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

Pro signatury, které nepoužívají isControllable parametr, nebo je-li tento parametr zadán false , jsou hodiny časové osy, které jsou přidruženy k animaci, odebrány, jakmile animace dosáhne tečky "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. Proto po spuštění nemůže být animace restartována.Therefore the animation cannot be restarted after running once. Řízení animace také vyžaduje, aby scénář měl direktivu x:Name nebo aby byl přístupný odkazem v kódu.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Chování při předání může být zadáno jako atribut BeginStoryboard .Handoff behavior can be specified as an attribute of BeginStoryboard.

Použití HandoffBehavior psaníUsing the Compose HandoffBehavior

Když použijete Storyboard , AnimationTimeline nebo AnimationClock na vlastnost pomocí Compose HandoffBehavior , všechny Clock objekty dříve přidružené k této vlastnosti budou nadále spotřebovávat systémové prostředky; systém časování tyto hodiny neodstraní automaticky.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 nedocházelo k problémům s výkonem při použití velkého počtu hodin pomocí Compose , měli byste po dokončení odebrat z animovaných vlastností hodiny skládání.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. Existuje několik způsobů, jak odebrat hodiny:There are several ways to remove a clock:

To je primárně problém pro animace objektů, které mají dlouhou životnost.This is primarily an issue for animations on objects that have a long lifetime. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolňovány paměti.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Další informace o objektech hodin naleznete v tématu Přehled systému pro animace a časování.For more information about clock objects, see Animation and Timing System Overview.

Platí pro

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Zahájí sekvenci akcí obsažených v poskytnutém scénáři se zadaným stavem pro kontrolu animace po jejím spuštění.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

Scénář, který má začít.The storyboard to begin.

handoffBehavior
HandoffBehavior

Hodnota výčtu, která popisuje chování pro použití v případě, že je již animována vlastnost popsaná ve scénáři.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean

Deklaruje, zda lze animaci řídit (může být pozastavena) po jejím spuštění.Declares whether the animation is controllable (can be paused) after it is started.

Poznámky

Většina typických scénářů animace tuto metodu nepoužívá.Most typical animation scenarios do not use this method. Obvykle můžete vytvořit Storyboard BeginStoryboard prvek nebo v kódu a pak je umístit jako EventTrigger obsah elementu.Typically, you create the Storyboard or BeginStoryboard element in markup, and then you place these as the EventTrigger content on an element. Když událost aktivuje, animace se pak spustí.When triggered by the event, the animation then runs. Většinu aspektů ovládacího prvku Storyboard lze adresovat vlastnostmi, které jsou zpřístupněny v označení.Most of the control aspects of a Storyboard can be addressed by properties that are exposed in markup.

Pro signatury, které nepoužívají isControllable parametr, nebo je-li tento parametr zadán false , jsou hodiny časové osy, které jsou přidruženy k animaci, odebrány, jakmile animace dosáhne tečky "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. Proto po spuštění nemůže být animace restartována.Therefore the animation cannot be restarted after running once. Řízení animace také vyžaduje, aby scénář měl direktivu x:Name nebo aby byl přístupný odkazem v kódu.Controlling an animation also requires that the storyboard have an x:Name Directive or be accessible by reference in code.

Chování při předání může být zadáno jako atribut BeginStoryboard .Handoff behavior can be specified as an attribute of BeginStoryboard.

Použití HandoffBehavior psaníUsing the Compose HandoffBehavior

Když použijete Storyboard , AnimationTimeline nebo AnimationClock na vlastnost pomocí Compose HandoffBehavior , všechny Clock objekty dříve přidružené k této vlastnosti budou nadále spotřebovávat systémové prostředky; systém časování tyto hodiny neodstraní automaticky.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 nedocházelo k problémům s výkonem při použití velkého počtu hodin pomocí Compose , měli byste po dokončení odebrat z animovaných vlastností hodiny skládání.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. Existuje několik způsobů, jak odebrat hodiny:There are several ways to remove a clock:

To je primárně problém pro animace objektů, které mají dlouhou životnost.This is primarily an issue for animations on objects that have a long lifetime. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolňovány paměti.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Další informace o objektech hodin naleznete v tématu Přehled systému pro animace a časování.For more information about clock objects, see Animation and Timing System Overview.

Platí pro