FrameworkContentElement.BeginStoryboard 方法

定义

命名空间:

System.Windows

程序集:

PresentationFramework.dll

开始所提供的演示图板中包含的操作序列。

重载

BeginStoryboard(Storyboard)	开始所提供的演示图板中包含的操作序列。
BeginStoryboard(Storyboard, HandoffBehavior)	开始所提供的演示图板中包含的操作序列，其中指定了在该属性经过动画处理后要发生的行为的选项。
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)	开始所提供的演示图板中包含的操作序列，其中指定了在动画开始之后动画控件的状态。

BeginStoryboard(Storyboard)

开始所提供的演示图板中包含的操作序列。

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard);

public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard -> unit

Public Sub BeginStoryboard (storyboard As Storyboard)

参数

storyboard

Storyboard

要开始的演示图板。

注解

对于不使用 isControllable、 参数的签名，或者在指定false该参数时，与动画关联的时间线时钟在达到“填充”周期后立即删除。 因此，动画在运行一次后无法重启。 请注意，控制动画还要求将情节提要命名为或作为代码中的实例进行访问。

BeginStoryboard(Storyboard, HandoffBehavior)

开始所提供的演示图板中包含的操作序列，其中指定了在该属性经过动画处理后要发生的行为的选项。

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);

public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior -> unit

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)

参数

storyboard

Storyboard

要开始的演示图板。

handoffBehavior

HandoffBehavior

一个枚举值，该值描述演示图板中描述的属性在经过动画处理后要使用的行为。

注解

对于不使用 isControllable、 参数的签名，或者在指定false该参数时，与动画关联的时间线时钟在达到“填充”周期后立即删除。 因此，动画在运行一次后无法重启。 请注意，控制动画还要求将情节提要命名为或作为代码中的实例进行访问。

使用 Compose HandoffBehavior

使用HandoffBehaviorCompose 将 、 AnimationTimeline或 AnimationClock 应用于Storyboard属性时，以前与该属性关联的任何Clock对象将继续消耗系统资源;计时系统不会自动删除时钟。

为了避免在使用 Compose应用大量时钟时出现性能问题，应在动画属性完成后从这些时钟中删除组合时钟。 可通过多种方式删除时钟：

• 要从属性中删除所有时钟，请使用经动画处理的对象的 ApplyAnimationClock(DependencyProperty, AnimationClock) 或 BeginAnimation(DependencyProperty, AnimationTimeline) 方法。 将正在进行动画处理的属性指定为第一个参数，并将 null 指定为第二个参数。 这会从 属性中删除所有动画时钟。

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

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

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

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

开始所提供的演示图板中包含的操作序列，其中指定了在动画开始之后动画控件的状态。

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior, bool isControllable);

public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior, bool isControllable);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior * bool -> unit

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)

参数

storyboard

Storyboard

要开始的演示图板。

handoffBehavior

HandoffBehavior

一个枚举值，该值描述演示图板中描述的属性在经过动画处理后要使用的行为。

isControllable

Boolean

声明在动画开始后是否仍可以对它进行控制（可以暂停）。

注解

对于不使用 isControllable、 参数的签名，或者在指定false该参数时，与动画关联的时间线时钟在达到“填充”周期后立即删除。 因此，动画在运行一次后无法重启。 请注意，控制动画还要求将情节提要命名为或作为代码中的实例进行访问。

使用 Compose HandoffBehavior

使用HandoffBehaviorCompose 将 、 AnimationTimeline或 AnimationClock 应用于Storyboard属性时，以前与该属性关联的任何Clock对象将继续消耗系统资源;计时系统不会自动删除这些时钟。

为了避免在使用 Compose应用大量时钟时出现性能问题，应在动画属性完成后从这些时钟中删除组合时钟。 可通过多种方式删除时钟：

• 要从属性中删除所有时钟，请使用经动画处理的对象的 ApplyAnimationClock(DependencyProperty, AnimationClock) 或 BeginAnimation(DependencyProperty, AnimationTimeline) 方法。 将正在进行动画处理的属性指定为第一个参数，并将 null 指定为第二个参数。 这会从 属性中删除所有动画时钟。

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

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

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