Teilen über


UIElement.BeginAnimation Methode

Definition

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 -> unit
Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline)

Parameter

dp
DependencyProperty

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 -> unit
Public Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline, handoffBehavior As HandoffBehavior)

Parameter

dp
DependencyProperty

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.

Gilt für: