UIElement.BeginAnimation Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Inicia una animación para una propiedad animada especificada en este elemento.

Sobrecargas

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

BeginAnimation(DependencyProperty, AnimationTimeline)

Inicia una animación para una propiedad animada especificada en este elemento.

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

Propiedad que se va a animar, que se especifica como un identificador de propiedad de dependencia.

animation

AnimationTimeline

Escala de tiempo de la animación que se va a iniciar.

Implementaciones

BeginAnimation(DependencyProperty, AnimationTimeline)

Ejemplos

En el ejemplo siguiente se crea una animación, se le asigna y, a continuación, se llama BeginAnimation a para iniciarla.

// 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

Al comprobar si una propiedad está animada, tenga en cuenta que la animación comenzará y se considerará animada cuando se represente el primer fotograma más allá del punto inicial no animado.

Si el BeginTime para animation es null, se quitan las animaciones actuales y se mantiene el valor actual de la propiedad.

Si todo animation el valor es null, todas las animaciones se quitan de la propiedad y el valor de propiedad se revierte a su valor base. Sin embargo, la escala de tiempo de animación asociada originalmente no se detiene. Cualquier otra animación asignada a esa escala de tiempo seguirá ejecutándose.

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.

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)

Parámetros

dp

DependencyProperty

Propiedad que se va a animar, que se especifica como el identificador de propiedad de dependencia.

animation

AnimationTimeline

Escala de tiempo de la animación que va a aplicarse.

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.

Implementaciones

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Ejemplos

En el ejemplo siguiente se implementa un controlador que obtiene una animación existente de un recurso y, a continuación, llama a BeginAnimation con un comportamiento de entrega especificado.

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

Al comprobar si una propiedad está animada, tenga en cuenta que la animación comenzará y se considerará animada cuando se represente el primer fotograma más allá del punto inicial no animado.

Si el BeginTime para animation es null, se quitan las animaciones actuales y se mantiene el valor actual de la propiedad.

Si todo animation el valor es null, todas las animaciones se quitan de la propiedad y el valor de propiedad se revierte a su valor base. Sin embargo, la escala de tiempo de animación asociada originalmente no se detiene. Cualquier otra animación asignada a esa escala de tiempo seguirá ejecutándose.