Прочитать на английском

Поделиться через


UIElement.BeginAnimation Метод

Определение

Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.

Перегрузки

BeginAnimation(DependencyProperty, AnimationTimeline)

Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Запускает указанную анимацию для указанного анимированного свойства зависимостей этого элемента, с возможностью указания действий, которые следует предпринять при уже существующей анимации для данного свойства.

BeginAnimation(DependencyProperty, AnimationTimeline)

Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.

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

Параметры

dp
DependencyProperty

Свойство для анимации, указанное как идентификатор свойства зависимостей.

animation
AnimationTimeline

График для анимации.

Реализации

Примеры

В следующем примере создается анимация, назначается ее, а затем вызывается BeginAnimation для запуска.

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

Комментарии

При проверке анимации свойства обратите внимание, что анимация начнется и считается анимированной при отрисовки первого кадра за пределами неинимированной начальной точки.

BeginTime Если используется nullзначение foranimation, удаляются все текущие анимации, а текущее значение свойства хранится.

Если значение равно всему animation null, все анимации удаляются из свойства, а значение свойства возвращается к базовому значению. Однако исходная временная шкала анимации не останавливается. Все другие анимации, назначенные этой временной шкале, будут продолжать выполняться.

Применяется к

.NET Framework 4.8 и другие версии
Продукт Версии
.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
Windows Desktop 3.0, 3.1, 5, 6, 7

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Запускает указанную анимацию для указанного анимированного свойства зависимостей этого элемента, с возможностью указания действий, которые следует предпринять при уже существующей анимации для данного свойства.

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

Параметры

dp
DependencyProperty

Свойство для анимации, указанное как идентификатор свойства зависимостей.

animation
AnimationTimeline

График для анимации, которую следует применить.

handoffBehavior
HandoffBehavior

Значение перечисления, которое указывает, как новая анимация должна взаимодействовать с любыми текущими анимациями, уже влияющими на значение свойства.

Реализации

Примеры

В следующем примере реализуется обработчик, который получает существующую анимацию из ресурса, а затем вызывается BeginAnimation с заданным поведением передачи.

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

Комментарии

При проверке анимации свойства обратите внимание, что анимация начнется и считается анимированной при отрисовки первого кадра за пределами неинимированной начальной точки.

BeginTime Если используется nullзначение foranimation, удаляются все текущие анимации, а текущее значение свойства хранится.

Если значение равно всему animation null, все анимации удаляются из свойства, а значение свойства возвращается к базовому значению. Однако исходная временная шкала анимации не останавливается. Все другие анимации, назначенные этой временной шкале, будут продолжать выполняться.

Применяется к

.NET Framework 4.8 и другие версии
Продукт Версии
.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
Windows Desktop 3.0, 3.1, 5, 6, 7