UIElement.BeginAnimation Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicia uma animação para uma propriedade animada específica neste elemento.
Sobrecargas
| Name | Description |
|---|---|
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Inicia uma animação para uma propriedade animada específica neste elemento. |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Inicia uma animação específica para uma propriedade animada específica neste elemento, com a opção de especificar o que acontece se a propriedade já tiver uma animação em corrida. |
BeginAnimation(DependencyProperty, AnimationTimeline)
Inicia uma animação para uma propriedade animada específica 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 -> unitPublic Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline)Parâmetros
A propriedade a animar, que é especificada como um identificador de propriedade de dependência.
- animation
- AnimationTimeline
A linha temporal da animação para começar.
Implementações
Exemplos
O exemplo seguinte cria uma animação, atribui-a e depois chama BeginAnimation para a iniciar.
// 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)
Observações
Quando verificar se uma propriedade está animada, note que a animação começará e será considerada animada quando o primeiro frame para além do ponto de partida não animado for renderizado.
Se o BeginTime for animation for null, então quaisquer animações atuais são removidas e o valor atual da propriedade é mantido.
Se o valor total animation for null, todas as animações são removidas da propriedade e o valor da propriedade reverte para o seu valor base. No entanto, a linha temporal de animação originalmente associada não é interrompida. Quaisquer outras animações atribuídas a essa linha temporal continuarão a correr.
Aplica-se a
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)
Inicia uma animação específica para uma propriedade animada específica neste elemento, com a opção de especificar o que acontece se a propriedade já tiver uma animação em corrida.
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 -> unitPublic Sub BeginAnimation (dp As DependencyProperty, animation As AnimationTimeline, handoffBehavior As HandoffBehavior)Parâmetros
A propriedade a animar, que é especificada como o identificador da propriedade de dependência.
- animation
- AnimationTimeline
A linha temporal da animação a aplicar.
- handoffBehavior
- HandoffBehavior
Um valor da enumeração que especifica como a nova animação interage com quaisquer animações atuais (em curso) que já estejam a afetar o valor da propriedade.
Implementações
Exemplos
O exemplo seguinte implementa um handler que obtém uma animação existente a partir de um recurso e depois chama BeginAnimation com um comportamento de handoff 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
Observações
Quando verificar se uma propriedade está animada, note que a animação começará e será considerada animada quando o primeiro frame para além do ponto de partida não animado for renderizado.
Se o BeginTime for animation for null, então quaisquer animações atuais são removidas e o valor atual da propriedade é mantido.
Se o valor total animation for null, todas as animações são removidas da propriedade e o valor da propriedade reverte para o seu valor base. No entanto, a linha temporal de animação originalmente associada não é interrompida. Quaisquer outras animações atribuídas a essa linha temporal continuarão a correr.
