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 für dieses Element.
Überlädt
| Name | Beschreibung |
|---|---|
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Startet eine Animation für eine angegebene animierte Eigenschaft für dieses Element. |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Startet eine bestimmte Animation für eine angegebene animierte Eigenschaft für dieses Element, mit der Option anzugeben, was passiert, wenn die Eigenschaft bereits über eine ausgeführte Animation verfügt. |
BeginAnimation(DependencyProperty, AnimationTimeline)
Startet eine Animation für eine angegebene animierte Eigenschaft für dieses Element.
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)
Parameter
Die zu animierende Eigenschaft, die als Abhängigkeitseigenschaftsbezeichner angegeben wird.
- animation
- AnimationTimeline
Die Zeitachse der zu startenden Animation.
Implementiert
Beispiele
Im folgenden Beispiel wird eine Animation erstellt, zugewiesen und anschließend 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 wird, beachten Sie, dass die Animation beginnt und als animiert betrachtet wird, wenn der erste Frame über den nicht animierten Startpunkt hinaus gerendert wird.
Wenn dies BeginTimeanimation der Fall ist null, werden alle aktuellen Animationen entfernt, und der aktuelle Wert der Eigenschaft wird gehalten.
Wenn der gesamte animation Wert lautet 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 bestimmte Animation für eine angegebene animierte Eigenschaft für dieses Element, mit der Option anzugeben, was passiert, 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 -> unit
Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline, handoffBehavior As HandoffBehavior)
Parameter
Die zu animierende Eigenschaft, die als Abhängigkeitseigenschaftsbezeichner angegeben wird.
- animation
- AnimationTimeline
Die Zeitachse der anzuwendenden Animation.
- handoffBehavior
- HandoffBehavior
Ein Wert der Enumeration, der angibt, wie die neue Animation mit allen aktuellen (ausgeführten) Animationen interagiert, 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 wird, beachten Sie, dass die Animation beginnt und als animiert betrachtet wird, wenn der erste Frame über den nicht animierten Startpunkt hinaus gerendert wird.
Wenn dies BeginTimeanimation der Fall ist null, werden alle aktuellen Animationen entfernt, und der aktuelle Wert der Eigenschaft wird gehalten.
Wenn der gesamte animation Wert lautet 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.