Ler em inglês

Compartilhar via


UIElement.ApplyAnimationClock Método

Definição

Aplica uma animação a uma propriedade de dependência especificada nesse elemento.

Sobrecargas

ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica uma animação a uma propriedade de dependência especificada nesse elemento. Todas as animações existentes são interrompidas e substituídas pela nova animação.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Aplica uma animação a uma propriedade de dependência especificada nesse elemento, com a capacidade de especificar o que acontece se a propriedade já tiver uma animação em execução.

Comentários

Esse método é lacrado e não pode ser substituído.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica uma animação a uma propriedade de dependência especificada nesse elemento. Todas as animações existentes são interrompidas e substituídas pela nova animação.

C#
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);

Parâmetros

dp
DependencyProperty

O identificador da propriedade a ser animada.

clock
AnimationClock

O relógio de animação que controla e declara a animação.

Implementações

Exemplos

No exemplo a seguir, um RectanglemyAnimatedRectangle tem uma animação de tempo específica aplicada a ela chamando ApplyAnimationClock .

C#
// Create a DoubleAnimation to
// animate its width.
DoubleAnimation widthAnimation = 
    new DoubleAnimation(
        100,
        500, 
        new Duration(TimeSpan.FromSeconds(5)));
//widthAnimation.RepeatBehavior = RepeatBehavior.Forever;
widthAnimation.AutoReverse = true;
widthAnimation.SpeedRatio = 0.5;
        
// Create a clock from the animation.
myControllableClock = widthAnimation.CreateClock();

// Apply the clock to the rectangle's Width property.
animatedRectangle.ApplyAnimationClock(
    Rectangle.WidthProperty, myControllableClock);

Comentários

Para remover uma animação de uma propriedade, especifique o identificador dessa propriedade como dp e especifique clock como null. Isso remove a animação e a propriedade animada é definida como seu valor base. No entanto, o relógio de animação originalmente associado não é interrompido. Todas as outras animações atribuídas a esse relógio continuarão a ser executadas.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Aplica uma animação a uma propriedade de dependência especificada nesse elemento, com a capacidade de especificar o que acontece se a propriedade já tiver uma animação em execução.

C#
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

Parâmetros

dp
DependencyProperty

A propriedade a ser animada.

clock
AnimationClock

O relógio de animação que controla e declara a animação.

handoffBehavior
HandoffBehavior

Um valor da enumeração. O padrão é SnapshotAndReplace, que interromperá qualquer animação existente e substituirá pela nova.

Implementações

Comentários

Para remover uma animação de uma propriedade, especifique o identificador dessa propriedade como dp e especifique clock como null. Isso remove a animação e a propriedade animada é definida como seu valor base. No entanto, o relógio de animação originalmente associado não é interrompido. Todas as outras animações atribuídas a esse relógio continuarão a ser executadas.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9