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.

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

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.

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

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.

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

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.

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

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.