UIElement.BeginAnimation Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Uruchamia animację dla określonej właściwości animowanej w tym elemecie.

Przeciążenia

BeginAnimation(DependencyProperty, AnimationTimeline)	Uruchamia animację dla określonej właściwości animowanej w tym elemecie.
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Uruchamia określoną animację dla określonej właściwości animowanej w tym elemecie z opcją określenia, co się stanie, jeśli właściwość ma już uruchomioną animację.

BeginAnimation(DependencyProperty, AnimationTimeline)

Uruchamia animację dla określonej właściwości animowanej w tym elemecie.

public:
 virtual void BeginAnimation(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationTimeline ^ animation);

public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation);

abstract member BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline -> unit
override this.BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline -> unit

Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline)

Parametry

dp

DependencyProperty

Właściwość do animowania, która jest określona jako identyfikator właściwości zależności.

animation

AnimationTimeline

Oś czasu animacji do uruchomienia.

Implementuje

BeginAnimation(DependencyProperty, AnimationTimeline)

Przykłady

Poniższy przykład tworzy animację, przypisuje ją, a następnie wywołuje BeginAnimation , aby ją uruchomić.

// Animate the button's width.
DoubleAnimation widthAnimation = 
    new DoubleAnimation(120, 300, TimeSpan.FromSeconds(5));
widthAnimation.RepeatBehavior = RepeatBehavior.Forever;
widthAnimation.AutoReverse = true;
animatedButton.BeginAnimation(Button.WidthProperty, widthAnimation);

' Animate the button's width.
Dim widthAnimation As New DoubleAnimation(120, 300, TimeSpan.FromSeconds(5))
widthAnimation.RepeatBehavior = RepeatBehavior.Forever
widthAnimation.AutoReverse = True
animatedButton.BeginAnimation(Button.WidthProperty, widthAnimation)

Uwagi

Podczas sprawdzania, czy właściwość jest animowana, należy pamiętać, że animacja rozpocznie się i zostanie uznana za animowaną, gdy zostanie renderowana pierwsza ramka poza animowanym punktem początkowym.

Jeśli parametr BeginTime for animation to null, wszystkie bieżące animacje zostaną usunięte, a bieżąca wartość właściwości zostanie zatrzymana.

Jeśli cała animation wartość to null, wszystkie animacje zostaną usunięte z właściwości, a wartość właściwości zostanie przywrócona do wartości podstawowej. Jednak pierwotnie skojarzona oś czasu animacji nie została zatrzymana. Wszystkie inne animacje przypisane do tej osi czasu będą nadal działać.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Uruchamia określoną animację dla określonej właściwości animowanej w tym elemecie z opcją określenia, co się stanie, jeśli właściwość ma już uruchomioną animację.

public:
 virtual void BeginAnimation(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationTimeline ^ animation, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);

public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

abstract member BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.BeginAnimation : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationTimeline * System.Windows.Media.Animation.HandoffBehavior -> unit

Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline, handoffBehavior As HandoffBehavior)

Parametry

dp

DependencyProperty

Właściwość do animowania, która jest określona jako identyfikator właściwości zależności.

animation

AnimationTimeline

Oś czasu animacji do zastosowania.

handoffBehavior

HandoffBehavior

Wartość wyliczenia, która określa sposób interakcji nowej animacji z dowolnymi bieżącymi (uruchomionymi) animacjami, które mają już wpływ na wartość właściwości.

Implementuje

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Przykłady

Poniższy przykład implementuje procedurę obsługi, która uzyskuje istniejącą animację z zasobu, a następnie wywołuje BeginAnimation określone zachowanie przekazywania.

private void myFrameNavigated(object sender, NavigationEventArgs args)
{
    DoubleAnimation myFadeInAnimation = (DoubleAnimation)this.Resources["MyFadeInAnimationResource"];
    myFrame.BeginAnimation(Frame.OpacityProperty, myFadeInAnimation, HandoffBehavior.SnapshotAndReplace);
}

Private Sub myFrameNavigated(ByVal sender As Object, ByVal args As NavigationEventArgs)
    Dim myFadeInAnimation As DoubleAnimation = CType(Me.Resources("MyFadeInAnimationResource"), DoubleAnimation)
    myFrame.BeginAnimation(Frame.OpacityProperty, myFadeInAnimation, HandoffBehavior.SnapshotAndReplace)
End Sub

Uwagi

Podczas sprawdzania, czy właściwość jest animowana, należy pamiętać, że animacja rozpocznie się i zostanie uznana za animowaną, gdy zostanie renderowana pierwsza ramka poza animowanym punktem początkowym.

Jeśli parametr BeginTime for animation to null, wszystkie bieżące animacje zostaną usunięte, a bieżąca wartość właściwości zostanie zatrzymana.

Jeśli cała animation wartość to null, wszystkie animacje zostaną usunięte z właściwości, a wartość właściwości zostanie przywrócona do wartości podstawowej. Jednak pierwotnie skojarzona oś czasu animacji nie została zatrzymana. Wszystkie inne animacje przypisane do tej osi czasu będą nadal działać.