UIElement.BeginAnimation UIElement.BeginAnimation UIElement.BeginAnimation UIElement.BeginAnimation Method

Definition

Startet eine Animation für eine angegebene animierte Eigenschaft dieses Elements.Starts an animation for a specified animated property on this element.

Überlädt

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

Startet eine Animation für eine angegebene animierte Eigenschaft dieses Elements.Starts an animation for a specified animated property on this element.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) 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.Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

Startet eine Animation für eine angegebene animierte Eigenschaft dieses Elements.Starts an animation for a specified animated property on this 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

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Die zu animierende Eigenschaft, die als Bezeichner einer Abhängigkeitseigenschaft angegeben wird.The property to animate, which is specified as a dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

Die Zeitachse der zu startenden Animation.The timeline of the animation to start.

Implementiert

Beispiele

Das folgende Beispiel erstellt eine Animation, weist sie und ruft dann BeginAnimation zu starten.The following example creates an animation, assigns it, and then calls BeginAnimation to start it.

// 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 betrachtet animiert, wenn der erste Frame hinter den nicht animierten Ausgangspunkt gerendert wird.When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

Wenn die BeginTime für animation ist nullwerden aktuellen Animationen entfernt und anschließend der aktuelle Wert der Eigenschaft gespeichert wird.If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Wenn die gesamte animation Wert null, werden alle Animationen aus der Eigenschaft entfernt, und der Eigenschaftswert wird auf den Basiswert zurückgesetzt.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Die ursprünglich zugeordnete Animationszeitachse wird jedoch nicht beendet.However, the originally associated animation timeline is not stopped. Alle anderen Animationen, die diese Zeitachse zugewiesen werden weiterhin ausgeführt.Any other animations assigned to that timeline will continue to run.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) 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.Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

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

Parameter

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Die zu animierende Eigenschaft, die als Bezeichner einer Abhängigkeitseigenschaft angegeben wird.The property to animate, which is specified as the dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

Die Zeitachse der anzuwendenden Animation.The timeline of the animation to be applied.

handoffBehavior
HandoffBehavior HandoffBehavior 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.A value of the enumeration that specifies how the new animation interacts with any current (running) animations that are already affecting the property value.

Implementiert

Beispiele

Das folgende Beispiel implementiert einen Handler, der eine vorhandene Animation aus einer Ressource und ruft dann erhält BeginAnimation mit einem angegebenen Übergabeverhalten.The following example implements a handler that obtains an existing animation from a resource and then calls BeginAnimation with a specified handoff behavior.

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 betrachtet animiert, wenn der erste Frame hinter den nicht animierten Ausgangspunkt gerendert wird.When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

Wenn die BeginTime für animation ist nullwerden aktuellen Animationen entfernt und anschließend der aktuelle Wert der Eigenschaft gespeichert wird.If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Wenn die gesamte animation Wert null, werden alle Animationen aus der Eigenschaft entfernt, und der Eigenschaftswert wird auf den Basiswert zurückgesetzt.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Die ursprünglich zugeordnete Animationszeitachse wird jedoch nicht beendet.However, the originally associated animation timeline is not stopped. Alle anderen Animationen, die diese Zeitachse zugewiesen werden weiterhin ausgeführt.Any other animations assigned to that timeline will continue to run.

Gilt für: