UIElement.BeginAnimation Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Inicia uma animação de uma propriedade animada especificada neste elemento.

Sobrecargas

BeginAnimation(DependencyProperty, AnimationTimeline)	Inicia uma animação de uma propriedade animada especificada neste elemento.
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Inicia uma animação específica para uma propriedade animada especificada neste elemento, com a opção de especificar o que acontece se a propriedade já tiver uma animação em execução.

BeginAnimation(DependencyProperty, AnimationTimeline)

Inicia uma animação de uma propriedade animada especificada neste elemento.

C#

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

Parâmetros

dp

DependencyProperty

A propriedade a ser animada, que é especificada como um identificador da propriedade de dependência.

animation

AnimationTimeline

A linha do tempo da animação a ser iniciada.

Implementações

BeginAnimation(DependencyProperty, AnimationTimeline)

Exemplos

O exemplo a seguir cria uma animação, atribui e chama BeginAnimation para iniciá-la.

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

Comentários

Quando você verificar se uma propriedade é animada, observe que a animação começará e será considerada animada quando o primeiro quadro além do ponto de partida não animado for renderizado.

Se for , animationnulltodas as BeginTime animações atuais serão removidas e o valor atual da propriedade será mantido.

Se o valor inteiro animation for null, todas as animações serão removidas da propriedade e o valor da propriedade será revertido para seu valor base. No entanto, a linha do tempo de animação originalmente associada não é interrompida. Quaisquer outras animações atribuídas a essa linha do tempo continuarão a ser executadas.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Inicia uma animação específica para uma propriedade animada especificada neste elemento, com a opção de especificar o que acontece se a propriedade já tiver uma animação em execução.

C#

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

Parâmetros

dp

DependencyProperty

A propriedade a ser animada, que é especificada como o identificador da propriedade de dependência.

animation

AnimationTimeline

A linha do tempo da animação a ser aplicada.

handoffBehavior

HandoffBehavior

Um valor de enumeração que especifica como a nova animação interage com todas as animações atuais (em execução) que já estão afetando o valor da propriedade.

Implementações

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Exemplos

O exemplo a seguir implementa um manipulador que obtém uma animação existente de um recurso e, em seguida, chama BeginAnimation com um comportamento de entrega especificado.

C#

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

Comentários

Quando você verificar se uma propriedade é animada, observe que a animação começará e será considerada animada quando o primeiro quadro além do ponto de partida não animado for renderizado.

Se for , animationnulltodas as BeginTime animações atuais serão removidas e o valor atual da propriedade será mantido.

Se o valor inteiro animation for null, todas as animações serão removidas da propriedade e o valor da propriedade será revertido para seu valor base. No entanto, a linha do tempo de animação originalmente associada não é interrompida. Quaisquer outras animações atribuídas a essa linha do tempo continuarão a ser executadas.