UIElement.BeginAnimation Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet eine Animation für eine angegebene animierte Eigenschaft dieses Elements.
Überlädt
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Startet eine Animation für eine angegebene animierte Eigenschaft dieses Elements. |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Startet eine spezifische Animation für eine bestimmte animierte Eigenschaft dieses Elements, wobei angegeben werden kann, welches Verhalten gelten soll, wenn die Eigenschaft bereits über eine ausgeführte Animation verfügt. |
BeginAnimation(DependencyProperty, AnimationTimeline)
Startet eine Animation für eine angegebene animierte Eigenschaft dieses Elements.
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)Parameter
Die zu animierende Eigenschaft, die als Bezeichner einer Abhängigkeitseigenschaft angegeben wird.
- animation
- AnimationTimeline
Die Zeitachse der zu startenden Animation.
Implementiert
Beispiele
Im folgenden Beispiel wird eine Animation erstellt, zugewiesen und dann aufgerufen BeginAnimation , um sie zu starten.
// 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)
Hinweise
Wenn Sie überprüfen, ob eine Eigenschaft animiert ist, beachten Sie, dass die Animation beginnt und als animiert betrachtet wird, wenn der erste Frame über den nicht animierten Startpunkt hinaus gerendert wird.
Wenn der BeginTime für animation ist null, werden alle aktuellen Animationen entfernt, und der aktuelle Wert der Eigenschaft wird gehalten.
Wenn der gesamte animation Wert ist null, werden alle Animationen aus der -Eigenschaft entfernt, und der Eigenschaftswert wird auf den Basiswert zurückgesetzt. Die ursprünglich zugeordnete Animationszeitachse wird jedoch nicht beendet. Alle anderen Animationen, die dieser Zeitachse zugewiesen sind, werden weiterhin ausgeführt.
Gilt für:
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)
Startet eine spezifische Animation für eine bestimmte animierte Eigenschaft dieses Elements, wobei angegeben werden kann, welches Verhalten gelten soll, wenn die Eigenschaft bereits über eine ausgeführte Animation verfügt.
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)Parameter
Die zu animierende Eigenschaft, die als Bezeichner einer Abhängigkeitseigenschaft angegeben wird.
- animation
- AnimationTimeline
Die Zeitachse der anzuwendenden Animation.
- handoffBehavior
- HandoffBehavior
Ein Wert der Enumeration, der angibt, wie die neue Animation mit aktuellen (ausgeführten) Animationen interagieren soll, die sich bereits auf den Eigenschaftswert auswirken.
Implementiert
Beispiele
Im folgenden Beispiel wird ein Handler implementiert, der eine vorhandene Animation aus einer Ressource abruft und dann mit einem angegebenen Übergabeverhalten aufruft BeginAnimation .
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
Hinweise
Wenn Sie überprüfen, ob eine Eigenschaft animiert ist, beachten Sie, dass die Animation beginnt und als animiert betrachtet wird, wenn der erste Frame über den nicht animierten Startpunkt hinaus gerendert wird.
Wenn der BeginTime für animation ist null, werden alle aktuellen Animationen entfernt, und der aktuelle Wert der Eigenschaft wird gehalten.
Wenn der gesamte animation Wert ist null, werden alle Animationen aus der -Eigenschaft entfernt, und der Eigenschaftswert wird auf den Basiswert zurückgesetzt. Die ursprünglich zugeordnete Animationszeitachse wird jedoch nicht beendet. Alle anderen Animationen, die dieser Zeitachse zugewiesen sind, werden weiterhin ausgeführt.
