UIElement.BeginAnimation Metoda
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Uruchamia animację dla określonej właściwości animowanej w tym elemecie.
| 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 -> unitPublic Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline)Parametry
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
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ć.
Dotyczy
.NET Framework 4.8 i inne wersje
| Produkt | Wersje |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |
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 -> unitPublic Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline, handoffBehavior As HandoffBehavior)Parametry
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
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ć.
Dotyczy
.NET Framework 4.8 i inne wersje
| Produkt | Wersje |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |