BeginStoryboard.HandoffBehavior 屬性

定義

命名空間:

System.Windows.Media.Animation

組件:

PresentationFramework.dll

取得或設定適當的遞交行為，藉此在這個分鏡腳本中啟動動畫時鐘。

public:
 property System::Windows::Media::Animation::HandoffBehavior HandoffBehavior { System::Windows::Media::Animation::HandoffBehavior get(); void set(System::Windows::Media::Animation::HandoffBehavior value); };

public System.Windows.Media.Animation.HandoffBehavior HandoffBehavior { get; set; }

member this.HandoffBehavior : System.Windows.Media.Animation.HandoffBehavior with get, set

Public Property HandoffBehavior As HandoffBehavior

屬性值

HandoffBehavior

其中一個 HandoffBehavior 列舉值。 預設值是 SnapshotAndReplace。

備註

使用 Compose HandoffBehavior

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

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

• 若要從 屬性中移除所有時鐘，請使用 ApplyAnimationClock(DependencyProperty, AnimationClock) 動畫物件的 或 BeginAnimation(DependencyProperty, AnimationTimeline) 方法。 指定要以動畫顯示的屬性做為第一個參數，並 null 指定為第二個參數。 這將會從屬性移除所有動畫時鐘。

• 若要從時鐘清單中移除特定 AnimationClock ，請使用 Controller 的 AnimationClock 屬性來擷取 ClockController ，然後呼叫 Remove 的 ClockController 方法。 這通常是在時鐘的 Completed 事件處理常式中完成。 請注意，只有根時鐘可以由 ClockController 控制; Controller 子時鐘的 屬性會傳 null 回 。 另請注意， Completed 如果時鐘的有效持續時間為永久，則不會呼叫 事件。 在此情況下，使用者必須判斷何時呼叫 Remove 。

這主要是在存留期較長的物件才會發生的動畫問題。 當物件被垃圾收集時，其時鐘也會中斷連線並垃圾收集。

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