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

定義

指定した DependencyProperty を使用して、指定した AnimationClock をアニメーション化します。Animates the specified DependencyProperty using the specified AnimationClock.

オーバーロード

ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock を指定した DependencyProperty に適用します。Applies an AnimationClock to the specified DependencyProperty. プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。If the property is already animated, the SnapshotAndReplace handoff behavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock を指定した DependencyProperty に適用します。Applies an AnimationClock to the specified DependencyProperty. プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。If the property is already animated, the specified HandoffBehavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock)

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)

パラメーター

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

アニメーション化するプロパティ。The property to animate.

clock
AnimationClock AnimationClock AnimationClock 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) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

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

パラメーター

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

アニメーション化するプロパティ。The property to animate.

clock
AnimationClock AnimationClock AnimationClock 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 であり、クロックが null である場合、このメソッドは無効です。If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

プロパティ値に既に影響を及ぼしている現在のアニメーションと新しいアニメーションが対話する方法を指定する値。A value that specifies how the new animation should interact with any current animations already affecting the property value.

実装

次の例は、さまざまな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.

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

適用対象