FrameworkElement.BeginStoryboard Metoda

Definice

Zahájí sekvenci akcí obsažených v zadaném scénáři.

Přetížení

BeginStoryboard(Storyboard)

Zahájí sekvenci akcí, které jsou obsaženy v poskytnutém scénáři.

BeginStoryboard(Storyboard, HandoffBehavior)

Zahájí posloupnost 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 už animovaná.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Zahájí posloupnost akcí obsažených v poskytnutém scénáři se zadaným stavem pro řízení animace po spuštění.

BeginStoryboard(Storyboard)

Zahájí sekvenci akcí, které jsou obsaženy v poskytnutém scénáři.

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.

Příklady

Následující příklad načte z prostředků a pak ji spustí, když je zpracována Storyboard Storyboard vnitřní událost třídy.

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 nevyu imisuje. Obvykle vytvoříte element nebo v kódu a pak je umístěte Storyboard BeginStoryboard jako obsah EventTrigger elementu. Po aktivaci událostí se pak animace spustí. Většinu řídicích aspektů lze řešit Storyboard pomocí vlastností, které jsou vystaveny ve značce.

Pro podpisy, které nemají parametr , nebo pokud je zadaný tento parametr , se hodiny časové osy přidružené k animaci odebraly, jakmile animace dosáhne tečky isControllable false "Fill". Proto animaci nelze po spuštění jednou restartovat. Řízení animace také vyžaduje, aby scénář měl direktivu x:Name nebo byl přístupný odkazem v kódu.

Platí pro

BeginStoryboard(Storyboard, HandoffBehavior)

Zahájí posloupnost 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 už animovaná.

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ý se má začít

handoffBehavior
HandoffBehavior

Hodnota výčtu, která popisuje chování, které se má použít, pokud je vlastnost popsaná ve scénáři už animovaná.

Příklady

Následující příklad načte z prostředků a pak ji spustí, když je zpracována Storyboard Storyboard vnitřní událost třídy.

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 nevyu imisuje. Obvykle vytvoříte element nebo v kódu a pak je umístěte Storyboard BeginStoryboard jako obsah EventTrigger elementu. Po aktivaci událostí se pak animace spustí. Většinu řídicích aspektů lze řešit Storyboard pomocí vlastností, které jsou vystaveny ve značce.

Pro podpisy, které nemají parametr , nebo pokud je zadaný tento parametr , se hodiny časové osy přidružené k animaci odebraly, jakmile animace dosáhne tečky isControllable false "Fill". Proto animaci nelze po spuštění jednou restartovat. Řízení animace také vyžaduje, aby scénář měl direktivu x:Name nebo byl přístupný odkazem v kódu.

Chování předání lze zadat jako atribut BeginStoryboard .

Použití HandoffBehavior psaní

Při použití , nebo na vlastnost pomocí , všechny objekty dříve přidružené k této vlastnosti nadále spotřebovávají systémové prostředky; systém časování neodebere Storyboard AnimationTimeline hodiny AnimationClock Compose HandoffBehavior Clock automaticky.

Pokud se chcete vyhnout problémům s výkonem při použití velkého počtu hodin pomocí , měli byste po dokončení z animované vlastnosti odebrat skládání Compose hodin. Hodiny je možné odebrat několika způsoby:

Jedná se primárně o problém s animacemi u objektů, které mají dlouhou životnost. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolněny z paměti.

Další informace o objektech hodin najdete v tématu Animation and Timing System Overview.

Platí pro

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Zahájí posloupnost akcí obsažených v poskytnutém scénáři se zadaným stavem pro řízení animace po spuštění.

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ý se má začít

handoffBehavior
HandoffBehavior

Hodnota výčtu, která popisuje chování, které se má použít, pokud je vlastnost popsaná ve scénáři už animovaná.

isControllable
Boolean

Deklaruje, jestli je animace po spuštění ovládatelná (lze ji pozastavit).

Poznámky

Většina typických scénářů animace tuto metodu nevyu imisuje. Obvykle vytvoříte element nebo v kódu a pak je umístěte Storyboard BeginStoryboard jako obsah EventTrigger elementu. Po aktivaci událostí se pak animace spustí. Většinu řídicích aspektů lze řešit Storyboard pomocí vlastností, které jsou vystaveny ve značce.

Pro podpisy, které nemají parametr , nebo pokud je zadaný tento parametr , se hodiny časové osy přidružené k animaci odebraly, jakmile animace dosáhne tečky isControllable false "Fill". Proto animaci nelze po spuštění jednou restartovat. Řízení animace také vyžaduje, aby scénář měl direktivu x:Name nebo byl přístupný odkazem v kódu.

Chování předání lze zadat jako atribut BeginStoryboard .

Použití HandoffBehavior psaní

Při použití , nebo na vlastnost pomocí , všechny objekty dříve přidružené k této vlastnosti nadále spotřebovávají systémové prostředky; systém časování neodebere Storyboard AnimationTimeline hodiny AnimationClock Compose HandoffBehavior Clock automaticky.

Pokud se chcete vyhnout problémům s výkonem při použití velkého počtu hodin pomocí , měli byste po dokončení z animované vlastnosti odebrat skládání Compose hodin. Hodiny je možné odebrat několika způsoby:

Jedná se primárně o problém s animacemi u objektů, které mají dlouhou životnost. Když je objekt uvolněn z paměti, jeho hodiny jsou také odpojeny a uvolněny z paměti.

Další informace o objektech hodin najdete v tématu Animation and Timing System Overview.

Platí pro