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

Définition

Lance une animation pour une propriété animée spécifiée sur cet élément.Starts an animation for a specified animated property on this element.

Surcharges

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

Lance une animation pour une propriété animée spécifiée sur cet élément.Starts an animation for a specified animated property on this element.

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

Lance une animation spécifique pour une propriété animée spécifiée sur cet élément, avec l'option de la spécification de ce qui arrive si la propriété possède déjà une animation en cours d'exécution.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)

Lance une animation pour une propriété animée spécifiée sur cet élément.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)

Paramètres

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propriété permettant d'animer, spécifiée sous forme d'identificateur de propriété de dépendance.The property to animate, which is specified as a dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

Chronologie de l'animation à lancer.The timeline of the animation to start.

Implémente

Exemples

L’exemple suivant crée une animation, il assigne, puis appelle BeginAnimation pour le démarrer.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)

Remarques

Lorsque vous vérifiez si une propriété est animée, notez que l’animation commence et être considéré comme animée lorsque la première image au-delà du point de départ non animées est rendue.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.

Si le BeginTime pour animation est null, puis les animations en cours sont supprimées et la valeur actuelle de la propriété est conservée.If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Si l’ensemble du animation valeur est null, toutes les animations sont supprimées de la propriété et la valeur de propriété revient à sa valeur de base.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Toutefois, la chronologie d’animation associée au départ n’est pas arrêtée.However, the originally associated animation timeline is not stopped. Toutes les autres animations assignées à cette chronologie continue à s’exécuter.Any other animations assigned to that timeline will continue to run.

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

Lance une animation spécifique pour une propriété animée spécifiée sur cet élément, avec l'option de la spécification de ce qui arrive si la propriété possède déjà une animation en cours d'exécution.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

Paramètres

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propriété permettant d'animer, spécifiée sous forme d'identificateur de propriété de dépendance.The property to animate, which is specified as the dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

Chronologie de l'animation à s'appliquer.The timeline of the animation to be applied.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

Valeur quelconque de l'énumération qui spécifie comment la nouvelle animation interagit avec toute animation en cours affectant déjà la valeur de la propriété.A value of the enumeration that specifies how the new animation interacts with any current (running) animations that are already affecting the property value.

Implémente

Exemples

L’exemple suivant implémente un gestionnaire qui obtient une animation d’une ressource, puis appelle BeginAnimation avec un comportement de transfert spécifié.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

Remarques

Lorsque vous vérifiez si une propriété est animée, notez que l’animation commence et être considéré comme animée lorsque la première image au-delà du point de départ non animées est rendue.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.

Si le BeginTime pour animation est null, puis les animations en cours sont supprimées et la valeur actuelle de la propriété est conservée.If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Si l’ensemble du animation valeur est null, toutes les animations sont supprimées de la propriété et la valeur de propriété revient à sa valeur de base.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Toutefois, la chronologie d’animation associée au départ n’est pas arrêtée.However, the originally associated animation timeline is not stopped. Toutes les autres animations assignées à cette chronologie continue à s’exécuter.Any other animations assigned to that timeline will continue to run.

S’applique à