FrameworkElement.BeginStoryboard Metod

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)

Parametrar

Exempel

I följande exempel hämtas en Storyboard från resurser och körs sedan när Storyboard en intern händelse hanteras av klassen.

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

Kommentarer

De flesta typiska animeringsscenarier använder inte den här metoden. Vanligtvis skapar du elementet Storyboard eller BeginStoryboard i markering och placerar dem sedan som EventTrigger innehåll på ett element. När den utlöses av händelsen körs animeringen. De flesta kontrollaspekter i en Storyboard kan hanteras av egenskaper som exponeras i markering.

För signaturer som inte använder parametern isControllable, eller när parametern har angetts falsetas tidslinjeklockorna som är associerade med animeringen bort så snart animeringen når fyllningsperioden. Animeringen kan därför inte startas om när den har körts en gång. Att styra en animering kräver också att storyboarden har ett x:Name-direktiv eller är tillgängligt med referens i kod.

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)

Parametrar

Exempel

I följande exempel hämtas en Storyboard från resurser och körs sedan när Storyboard en intern händelse hanteras av klassen.

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

Kommentarer

De flesta typiska animeringsscenarier använder inte den här metoden. Vanligtvis skapar du elementet Storyboard eller BeginStoryboard i markering och placerar dem sedan som EventTrigger innehåll på ett element. När den utlöses av händelsen körs animeringen. De flesta kontrollaspekter i en Storyboard kan hanteras av egenskaper som exponeras i markering.

För signaturer som inte använder parametern isControllable, eller när parametern har angetts falsetas tidslinjeklockorna som är associerade med animeringen bort så snart animeringen når fyllningsperioden. Animeringen kan därför inte startas om när den har körts en gång. Att styra en animering kräver också att storyboarden har ett x:Name-direktiv eller är tillgängligt med referens i kod.

Överlämningsbeteende kan anges som ett attribut för BeginStoryboard.

Använda Compose HandoffBehavior

När du tillämpar en Storyboard, AnimationTimeline, eller AnimationClock på en egenskap med hjälp ComposeHandoffBehaviorav , fortsätter alla Clock objekt som tidigare var associerade med den egenskapen att förbruka systemresurser. Tidsschemat tar inte bort klockorna automatiskt.

För att undvika prestandaproblem när du använder ett stort antal klockor med hjälp Composeav bör du ta bort komponerande klockor från den animerade egenskapen när de har slutförts. Det finns flera sätt att ta bort en klocka:

• Om du vill ta bort alla klockor från en egenskap använder du metoden ApplyAnimationClock(DependencyProperty, AnimationClock) eller BeginAnimation(DependencyProperty, AnimationTimeline) för det animerade objektet. Ange egenskapen som ska animeras som den första parametern och null som den andra. Detta tar bort alla animeringsklockor från egenskapen.

• Om du vill ta bort en specifik AnimationClock från en lista med klockor använder du egenskapen Controller för AnimationClock för att hämta en ClockControlleroch anropar sedan metoden Remove för ClockController. Detta görs vanligtvis i Completed händelsehanterare för en klocka. Observera att endast rotklockor kan styras av en ClockController. Egenskapen för en underordnad Controller klocka returnerar null. Observera också att händelsen Completed inte utlöses om den effektiva varaktigheten för klockan är för evigt. I så fall måste användaren bestämma när Remove.

Det här är främst ett problem för animeringar på objekt som har en lång livslängd. När ett objekt är skräpinsamling kopplas även klockorna från och skräp samlas in.

Mer information om klockobjekt finns i Översikt över animerings- och tidsschemasystem.

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)

Parametrar

Kommentarer

De flesta typiska animeringsscenarier använder inte den här metoden. Vanligtvis skapar du elementet Storyboard eller BeginStoryboard i markering och placerar dem sedan som EventTrigger innehåll på ett element. När den utlöses av händelsen körs animeringen. De flesta kontrollaspekter i en Storyboard kan hanteras av egenskaper som exponeras i markering.

För signaturer som inte använder parametern isControllable, eller när parametern har angetts falsetas tidslinjeklockorna som är associerade med animeringen bort så snart animeringen når fyllningsperioden. Animeringen kan därför inte startas om när den har körts en gång. Att styra en animering kräver också att storyboarden har ett x:Name-direktiv eller är tillgängligt med referens i kod.

Överlämningsbeteende kan anges som ett attribut för BeginStoryboard.

Använda Compose HandoffBehavior

När du tillämpar en Storyboard, AnimationTimeline, eller AnimationClock på en egenskap med hjälp ComposeHandoffBehaviorav , fortsätter alla Clock objekt som tidigare var associerade med den egenskapen att förbruka systemresurser. Tidsschemat tar inte bort klockorna automatiskt.

För att undvika prestandaproblem när du använder ett stort antal klockor med hjälp Composeav bör du ta bort komponerande klockor från den animerade egenskapen när de har slutförts. Det finns flera sätt att ta bort en klocka:

• Om du vill ta bort alla klockor från en egenskap använder du metoden ApplyAnimationClock(DependencyProperty, AnimationClock) eller BeginAnimation(DependencyProperty, AnimationTimeline) för det animerade objektet. Ange egenskapen som ska animeras som den första parametern och null som den andra. Detta tar bort alla animeringsklockor från egenskapen.

• Om du vill ta bort en specifik AnimationClock från en lista med klockor använder du egenskapen Controller för AnimationClock för att hämta en ClockControlleroch anropar sedan metoden Remove för ClockController. Detta görs vanligtvis i Completed händelsehanterare för en klocka. Observera att endast rotklockor kan styras av en ClockController. Egenskapen för en underordnad Controller klocka returnerar null. Observera också att händelsen Completed inte utlöses om den effektiva varaktigheten för klockan är för evigt. I så fall måste användaren bestämma när Remove.

Det här är främst ett problem för animeringar på objekt som har en lång livslängd. När ett objekt är skräpinsamling kopplas även klockorna från och skräp samlas in.

Mer information om klockobjekt finns i Översikt över animerings- och tidsschemasystem.