Animatable.ApplyAnimationClock メソッド

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.

作成 HandoffBehavior の使用Using the Compose HandoffBehavior

を使用してStoryboard AnimationTimeline AnimationClock プロパティにClock 、、またはを適用すると、そのプロパティに以前関連付けられていたすべてのオブジェクトが引き続きシステムリソースを消費します。タイミングシステムは、HandoffBehavior Composeこれらのクロックは自動的に削除されます。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 ClockControllerを取得し、 Removeのメソッドを呼び出します。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.