HandoffBehavior 列舉

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

指定新動畫如何與屬性上已套用的任何現有動畫進行互動。

public enum class HandoffBehavior

public enum HandoffBehavior

type HandoffBehavior =

Public Enum HandoffBehavior

Compose	1	新動畫會附加至撰寫鏈結結尾，以與現有動畫結合。
SnapshotAndReplace	0	新動畫會取代要套用之屬性上的任何現有動畫。

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

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

若要從屬性中移除所有時鐘，請使用 ApplyAnimationClock(DependencyProperty, AnimationClock) 動畫物件的或 BeginAnimation(DependencyProperty, AnimationTimeline) 方法。指定要以動畫顯示的屬性做為第一個參數，並 null 指定為第二個參數。這將會從屬性移除所有動畫時鐘。
若要從時鐘清單中移除特定 AnimationClock ，請使用 Controller 的 AnimationClock 屬性來擷取 ClockController ，然後呼叫 Remove 的 ClockController 方法。這通常是在時鐘的 Completed 事件處理常式中完成。請注意，只有根時鐘可以由 ClockController 控制; Controller 子時鐘的屬性會傳 null 回。另請注意， Completed 如果時鐘的有效持續時間為永久，則不會引發事件。在此情況下，使用者必須判斷何時呼叫 Remove 。

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

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