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.

C#

public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation);

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.

C#

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

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.

C#

public void BeginAnimation (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationTimeline animation, System.Windows.Media.Animation.HandoffBehavior 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.

C#

private void myFrameNavigated(object sender, NavigationEventArgs args)
{
    DoubleAnimation myFadeInAnimation = (DoubleAnimation)this.Resources["MyFadeInAnimationResource"];
    myFrame.BeginAnimation(Frame.OpacityProperty, myFadeInAnimation, HandoffBehavior.SnapshotAndReplace);
}

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.