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

使用 ComposeHandoffBehavior将 Storyboard、AnimationTimeline或 AnimationClock 应用于属性时，以前与该属性关联的任何 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

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

若要避免使用 Compose应用大量时钟时出现性能问题，应在动画属性完成后从动画属性中删除撰写时钟。 可通过多种方式删除时钟：

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

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

这主要是对生存期较长的对象进行动画的问题。 当对象被垃圾回收时，其时钟也会断开连接并回收垃圾。

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