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，请使用 AnimationClock 的 Controller 属性来检索 ClockController，然后调用 ClockController 的 Remove 方法。 这通常在某个时钟的 Completed 事件处理程序中完成。 请注意，只有根时钟可以由 ClockController控制; Controller 子时钟的 属性返回 null。 另请注意， Completed 如果时钟的有效持续时间是永久的，则不会调用 事件。 在这种情况下，用户必须确定何时调用 Remove。

此动画问题主要出现在生存期较长的对象上。 对对象进行垃圾回收时，其时钟也会断开连接并回收垃圾。

有关时钟对象的详细信息，请参阅动画和计时系统概述。