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

Definición

Inicia una animación para una propiedad animada especificada en este elemento.Starts an animation for a specified animated property on this element.

Sobrecargas

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

Inicia una animación para una propiedad animada especificada en este elemento.Starts an animation for a specified animated property on this element.

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

Inicia una animación concreta para una propiedad animada especificada en este elemento, con la opción de especificar lo que ocurre si la propiedad ya tiene una animación en ejecución.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)

Inicia una animación para una propiedad animada especificada en este elemento.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)

Parámetros

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propiedad que se va a animar, que se especifica como un identificador de propiedad de dependencia.The property to animate, which is specified as a dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

Escala de tiempo de la animación que se va a iniciar.The timeline of the animation to start.

Implementaciones

Ejemplos

En el ejemplo siguiente se crea una animación, se asigna y, a continuación BeginAnimation , se llama a para iniciarla.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)

Comentarios

Cuando se comprueba si una propiedad está animada, tenga en cuenta que la animación se iniciará y se considerará animada cuando se represente el primer fotograma más allá del punto inicial no animado.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.

BeginTime Si para animation es ,sequitanlasanimacionesactualesysemantieneelvaloractualdelapropiedad.nullIf the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Si el valor animation completo es null, todas las animaciones se quitan de la propiedad y el valor de la propiedad se revierte a su valor base.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Sin embargo, la escala de tiempo de animación asociada originalmente no se detiene.However, the originally associated animation timeline is not stopped. Cualquier otra animación asignada a esa escala de tiempo continuará ejecutándose.Any other animations assigned to that timeline will continue to run.

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

Inicia una animación concreta para una propiedad animada especificada en este elemento, con la opción de especificar lo que ocurre si la propiedad ya tiene una animación en ejecución.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

Parámetros

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propiedad que se va a animar, que se especifica como el identificador de propiedad de dependencia.The property to animate, which is specified as the dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

Escala de tiempo de la animación que va a aplicarse.The timeline of the animation to be applied.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

Valor de la enumeración que especifica la interacción de la nueva animación con cualquier animación actual (en ejecución) que ya afecte el valor de propiedad.A value of the enumeration that specifies how the new animation interacts with any current (running) animations that are already affecting the property value.

Implementaciones

Ejemplos

En el ejemplo siguiente se implementa un controlador que obtiene una animación existente de un recurso y, a BeginAnimation continuación, llama a con un comportamiento de entrega especificado.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

Comentarios

Cuando se comprueba si una propiedad está animada, tenga en cuenta que la animación se iniciará y se considerará animada cuando se represente el primer fotograma más allá del punto inicial no animado.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.

BeginTime Si para animation es ,sequitanlasanimacionesactualesysemantieneelvaloractualdelapropiedad.nullIf the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Si el valor animation completo es null, todas las animaciones se quitan de la propiedad y el valor de la propiedad se revierte a su valor base.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Sin embargo, la escala de tiempo de animación asociada originalmente no se detiene.However, the originally associated animation timeline is not stopped. Cualquier otra animación asignada a esa escala de tiempo continuará ejecutándose.Any other animations assigned to that timeline will continue to run.

Se aplica a