Animatable.ApplyAnimationClock Animatable.ApplyAnimationClock Animatable.ApplyAnimationClock Animatable.ApplyAnimationClock Method

AnimationClock を指定した DependencyProperty に適用します。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)

パラメーター

実装

注釈

このメソッドを使用して、プロパティからクロックを削除しても、クロックは停止しませんに注意してください。Note that using this method to removing clocks from a property does not stop those clocks.

AnimationClock を指定した DependencyProperty に適用します。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

パラメーター

実装

例

次の例は、異なるアニメーション クロックを適用する方法を示しています。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、anyClock以前そのプロパティに関連付けられているオブジェクトは引き続きシステム リソースを消費しますタイミング システムはありません。これらのクロックを自動的に削除します。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.

• プロパティからすべてのクロックを削除するには、使用、ApplyAnimationClock(DependencyProperty, AnimationClock)またはBeginAnimation(DependencyProperty, AnimationTimeline)アニメーション化されたオブジェクトのメソッド。To remove all clocks from a property, use the ApplyAnimationClock(DependencyProperty, AnimationClock) or BeginAnimation(DependencyProperty, AnimationTimeline) method of the animated object. 最初のパラメーターとしてアニメーション化されているプロパティを指定し、 null 2 つ目として。Specify the property being animated as the first parameter, and null as the second. これにより、すべてのアニメーション クロックがプロパティから削除されます。This will remove all animation clocks from the property.

• 特定を削除するAnimationClockクロックの一覧は、使用して、Controllerのプロパティ、AnimationClockを取得する、 ClockController、呼び出して、Removeのメソッド、ClockControllerします。To remove a specific AnimationClock from a list of clocks, use the Controller property of the AnimationClock to retrieve a ClockController, then call the Remove method of the ClockController. これは、通常、Completedクロックのイベント ハンドラー。This is typically done in the Completed event handler for a clock. 唯一のルート クロックを使用して制御できることに注意してください、 ClockController、Controller子クロックのプロパティを返しますnullします。Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock will return null. なお、Completedクロックの有効期間が永久の場合、イベントは呼び出されません。Note also that the Completed event will not be called if the effective duration of the clock is forever. その場合は、ユーザーを呼び出すタイミングを決定する必要があるRemoveします。In that case, the user will need to determine when to call Remove.

これは主に、有効期間が長いオブジェクトでのアニメーションの問題です。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.