UIElement.BeginAnimation Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

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

Перегрузки

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

BeginAnimation(DependencyProperty, AnimationTimeline)

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

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)

Параметры

dp

DependencyProperty

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

animation

AnimationTimeline

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

Реализации

BeginAnimation(DependencyProperty, AnimationTimeline)

Примеры

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

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

Комментарии

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

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

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

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

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

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)

Параметры

dp

DependencyProperty

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

animation

AnimationTimeline

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

handoffBehavior

HandoffBehavior

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

Реализации

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Примеры

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

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

Комментарии

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

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

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