Animatable.ApplyAnimationClock 方法

定義

使用指定的 DependencyProperty,建立指定的 AnimationClock 動畫。

多載

ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock 套用至指定的 DependencyProperty。 如果屬性已有動畫效果,即使用 SnapshotAndReplace 遞移式行為。

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock 套用至指定的 DependencyProperty。 如果已建立屬性的動畫,則會使用指定的 HandoffBehavior

ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock 套用至指定的 DependencyProperty。 如果屬性已有動畫效果,即使用 SnapshotAndReplace 遞移式行為。

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

要製作動畫的屬性。

clock
AnimationClock

建立指定屬性動畫效果的時鐘。 如果 clocknull,即移除指定屬性的所有動畫效果 (但不停止)。

實作

備註

請注意,使用這個方法從 屬性移除時鐘並不會停止這些時鐘。

適用於

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock 套用至指定的 DependencyProperty。 如果已建立屬性的動畫,則會使用指定的 HandoffBehavior

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
Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock, handoffBehavior As HandoffBehavior)

參數

dp
DependencyProperty

要製作動畫的屬性。

clock
AnimationClock

建立指定屬性動畫效果的時鐘。 如果 handoffBehaviorSnapshotAndReplaceclocknull,則會從指定的屬性移除所有動畫 (但不會停止)。 如果 handoffBehaviorCompose 且時鐘是 null,這個方法將不起任何作用。

handoffBehavior
HandoffBehavior

一個值,這個值指定新的動畫應該如何與已經影響屬性值的任何目前動畫互動。

實作

範例

下列範例示範如何使用不同的 HandoffBehavior 設定來套用動畫時鐘。

備註

請注意,使用此方法從 屬性移除時鐘並不會停止這些時鐘。

使用 Compose HandoffBehavior

當您使用 HandoffBehaviorCompose 將 、 AnimationTimelineAnimationClock 套用 Storyboard 至屬性時,先前與該屬性相關聯的任何 Clock 物件都會繼續取用系統資源;計時系統不會自動移除這些時鐘。

若要避免使用 套用 Compose 大量時鐘時的效能問題,您應該在動畫屬性完成之後,從動畫屬性中移除撰寫時鐘。 有幾個方式可移除時鐘。

這主要是在存留期較長的物件才會發生的動畫問題。 記憶體回收物件時,也會中斷連接並記憶體回收其時鐘。

如需時鐘物件的詳細資訊,請參閱 動畫和計時系統概觀

適用於