Animatable.ApplyAnimationClock 메서드

정의

지정된 DependencyProperty을 사용하여 지정된 AnimationClock에 애니메이션을 적용합니다.Animates the specified DependencyProperty using the specified AnimationClock.

오버로드

ApplyAnimationClock(DependencyProperty, AnimationClock)

지정된 DependencyPropertyAnimationClock을 적용합니다.Applies an AnimationClock to the specified DependencyProperty. 속성에 이미 애니메이션 효과가 적용되어 있으면 SnapshotAndReplace 전달 동작이 사용됩니다.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

지정된 DependencyPropertyAnimationClock을 적용합니다.Applies an AnimationClock to the specified DependencyProperty. 속성에 이미 애니메이션이 적용되어 있으면 지정된 HandoffBehavior가 사용됩니다.If the property is already animated, the specified HandoffBehavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock)

지정된 DependencyPropertyAnimationClock을 적용합니다.Applies an AnimationClock to the specified DependencyProperty. 속성에 이미 애니메이션 효과가 적용되어 있으면 SnapshotAndReplace 전달 동작이 사용됩니다.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock);
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);
abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock)

매개 변수

dp
DependencyProperty

애니메이션 효과를 주는 속성입니다.The property to animate.

clock
AnimationClock

지정된 속성에 애니메이션 효과를 주는 데 사용할 시계입니다.The clock with which to animate the specified property. clocknull인 경우 지정된 속성에서 모든 애니메이션이 중지되지 않고 제거됩니다.If clock is null, all animations will be removed from the specified property (but not stopped).

구현

설명

속성에서 시간이 제거 하려면이 메서드를 사용 하는 해당 시계를 중지 하지 않습니다.Note that using this method to removing clocks from a property does not stop those clocks.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

지정된 DependencyPropertyAnimationClock을 적용합니다.Applies an AnimationClock to the specified DependencyProperty. 속성에 이미 애니메이션이 적용되어 있으면 지정된 HandoffBehavior가 사용됩니다.If the property is already animated, the specified HandoffBehavior is used.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);
abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit

매개 변수

dp
DependencyProperty

애니메이션 효과를 주는 속성입니다.The property to animate.

clock
AnimationClock

지정된 속성에 애니메이션 효과를 주는 데 사용할 시계입니다.The clock with which to animate the specified property. handoffBehaviorSnapshotAndReplace이고 clocknull이면 모든 애니메이션이 지정된 속성에서 제거되지만 중지되지는 않습니다.If handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). handoffBehaviorCompose이고 Clock이 null이면 이 메서드를 사용해도 아무런 영향이 없습니다.If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior

새 애니메이션이 이미 속성 값에 영향을 주고 있는 현재 애니메이션과 상호 작용하는 방법을 지정하는 값입니다.A value that specifies how the new animation should interact with any current animations already affecting the property value.

구현

예제

다음 예제에서는 다른을 사용 하 여 애니메이션 clock을 적용 하는 방법을 보여 줍니다 HandoffBehavior 설정 합니다.The following example shows how to apply animation clocks using different HandoffBehavior settings.

설명

참고 속성에서 클록을 제거 하려면이 메서드를 사용 하 여 해당 클록을 중지 하지 않습니다.Note that using this method to remove clocks from a property does not stop those clocks.

사용 하 여 Compose HandoffBehaviorUsing the Compose HandoffBehavior

적용 하는 경우는 Storyboard, AnimationTimeline, 또는 AnimationClock 사용 하 여 속성을 Compose HandoffBehavior모든 Clock 타이밍 시스템 것입니다; 속성을 사용 하 여 이전에 연결 된 개체를 계속 시스템 리소스를 사용 하 자동으로 이러한 클록을 제거 합니다.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system will not remove these clocks automatically.

많은 수의 시계를 사용 하 여 적용 하는 경우 성능 문제를 방지 하려면 Compose를 완성 한 후 애니메이션된 속성에서 구성 중인 클록을 제거 해야 합니다.To avoid performance issues when you apply a large number of clocks using Compose, you should remove composing clocks from the animated property after they complete. 여러 가지 방법으로 클록을 제거할 수 있습니다.There are several ways to remove a clock.

이것은 주로 수명이 긴 개체에 대한 애니메이션에서 문제가 됩니다.This is primarily an issue for animations on objects that have a long lifetime. 개체가 가비지 수집될 경우 해당 클록도 연결이 끊어지고 가비지가 수집됩니다.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

클록 개체에 대 한 자세한 내용은 참조는 애니메이션 및 타이밍 시스템 개요합니다.For more information about clock objects, see the Animation and Timing System Overview.

적용 대상