UIElement.BeginAnimation UIElement.BeginAnimation UIElement.BeginAnimation UIElement.BeginAnimation Method

Определение

Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.Starts an animation for a specified animated property on this element.

Перегрузки

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.Starts an animation for a specified animated property on this element.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Запускает указанную анимацию для указанного анимированного свойства зависимостей этого элемента, с возможностью указания действий, которые следует предпринять при уже существующей анимации для данного свойства.Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

Запускает анимацию для указанного свойства данного элемента, имеющего анимацию.Starts an animation for a specified animated property on this element.

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 DependencyProperty DependencyProperty DependencyProperty

Свойство для анимации, указанное как идентификатор свойства зависимостей.The property to animate, which is specified as a dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

График для анимации.The timeline of the animation to start.

Реализации

Примеры

Следующий пример создает анимацию, назначает ему и затем вызывает BeginAnimation для его запуска.The following example creates an animation, assigns it, and then calls BeginAnimation to start it.

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

Комментарии

При проверке анимировано ли свойство, обратите внимание, что анимация начнет считаться анимации при отображении первый кадр не анимационные отправной точкой.When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

Если BeginTime для animation является null, любые текущие анимации будут удалены и текущее значение свойства будет сохранено.If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Если весь animation значение null, все анимации будут удалены из свойства, и свойство возвращается к базовому значению.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Тем не менее временной шкалы анимации не останавливается.However, the originally associated animation timeline is not stopped. Любые другие анимации, назначенные эту временную шкалу продолжит запуска.Any other animations assigned to that timeline will continue to run.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Запускает указанную анимацию для указанного анимированного свойства зависимостей этого элемента, с возможностью указания действий, которые следует предпринять при уже существующей анимации для данного свойства.Starts a specific animation for a specified animated property on this element, with the option of specifying what happens if the property already has a running animation.

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

Параметры

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Свойство для анимации, указанное как идентификатор свойства зависимостей.The property to animate, which is specified as the dependency property identifier.

animation
AnimationTimeline AnimationTimeline AnimationTimeline AnimationTimeline

График для анимации, которую следует применить.The timeline of the animation to be applied.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

Значение перечисления, которое указывает, как новая анимация должна взаимодействовать с любыми текущими анимациями, уже влияющими на значение свойства.A value of the enumeration that specifies how the new animation interacts with any current (running) animations that are already affecting the property value.

Реализации

Примеры

В следующем примере реализуется обработчик, который получает существующие анимации из ресурса, а затем вызывает BeginAnimation с указанным переадресуемое поведение.The following example implements a handler that obtains an existing animation from a resource and then calls BeginAnimation with a specified handoff behavior.

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

Комментарии

При проверке анимировано ли свойство, обратите внимание, что анимация начнет считаться анимации при отображении первый кадр не анимационные отправной точкой.When you check whether a property is animated, note that the animation will begin and be considered animated when the first frame beyond the non-animated starting point is rendered.

Если BeginTime для animation является null, любые текущие анимации будут удалены и текущее значение свойства будет сохранено.If the BeginTime for animation is null, then any current animations are removed and the current value of the property is held.

Если весь animation значение null, все анимации будут удалены из свойства, и свойство возвращается к базовому значению.If the entire animation value is null, all animations are removed from the property and the property value reverts to its base value. Тем не менее временной шкалы анимации не останавливается.However, the originally associated animation timeline is not stopped. Любые другие анимации, назначенные эту временную шкалу продолжит запуска.Any other animations assigned to that timeline will continue to run.

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