UIElement.BeginAnimation Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.
Перегрузки
| 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)
Параметры
Свойство для анимации, указанное как идентификатор свойства зависимостей.
- animation
- 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)
Параметры
Свойство для анимации, указанное как идентификатор свойства зависимостей.
- animation
- AnimationTimeline
График для анимации, которую следует применить.
- handoffBehavior
- 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, все анимации удаляются из свойства, а значение свойства возвращается к базовому значению. Однако исходная временная шкала анимации не останавливается. Все другие анимации, назначенные этой временной шкале, будут продолжать выполняться.