UIElement.BeginAnimation 메서드

정의

이 요소에서 지정된 애니메이션 속성에 대한 애니메이션을 시작합니다.Starts an animation for a specified animated property on this element.

오버로드

BeginAnimation(DependencyProperty, AnimationTimeline)

이 요소에서 지정된 애니메이션 속성에 대한 애니메이션을 시작합니다.Starts an animation for a specified animated property on this element.

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)

이 요소에서 지정된 애니메이션 속성에 대한 애니메이션을 시작합니다.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

종속성 속성 식별자로 지정된, 애니메이션을 지정할 속성입니다.The property to animate, which is specified as a dependency property identifier.

animation
AnimationTimeline

시작할 애니메이션의 Timeline입니다.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.

animation에 대 한 BeginTime 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)

속성에 이미 실행 중인 애니메이션이 있는 경우 수행할 동작을 지정하는 옵션을 사용하여 이 요소의 지정된 애니메이션 속성에 대해 특정 애니메이션을 시작합니다.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

종속성 속성 식별자로 지정된, 애니메이션을 지정할 속성입니다.The property to animate, which is specified as the dependency property identifier.

animation
AnimationTimeline

적용할 애니메이션의 Timeline입니다.The timeline of the animation to be applied.

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.

animation에 대 한 BeginTime 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.

적용 대상