FrameworkElement.BeginStoryboard 方法

定义

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

重载

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

要开始的演示图板。

示例

以下示例从资源中检索 Storyboard ,然后在处理内部事件时运行它 Storyboard

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim s As Storyboard

    s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
    Me.BeginStoryboard(s)
End Sub

注解

大多数典型的动画方案不使用此方法。 通常,在标记中创建 StoryboardBeginStoryboard 元素,然后将这些元素作为 EventTrigger 内容放在元素上。 由 事件触发时,动画随后运行。 的大多数控件方面 Storyboard 都可以通过标记中公开的属性来解决。

对于不使用 isControllable、 参数的签名,或者在指定false了该参数时,一旦动画达到“填充”周期,就会删除与动画关联的时间线时钟。 因此,动画在运行一次后无法重启。 控制动画还要求情节提要具有 x:Name 指令 或通过代码中的引用访问。

适用于

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

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

示例

以下示例从资源中检索 Storyboard ,然后在处理内部事件时运行它 Storyboard

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim s As Storyboard

    s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
    Me.BeginStoryboard(s)
End Sub

注解

大多数典型的动画方案不使用此方法。 通常,在标记中创建 StoryboardBeginStoryboard 元素,然后将这些元素作为 EventTrigger 内容放在元素上。 由 事件触发时,动画随后运行。 的大多数控件方面 Storyboard 都可以通过标记中公开的属性来解决。

对于不使用 isControllable、 参数的签名,或者在指定false了该参数时,一旦动画达到“填充”周期,就会删除与动画关联的时间线时钟。 因此,动画在运行一次后无法重启。 控制动画还要求情节提要具有 x:Name 指令 或通过代码中的引用访问。

交接行为可以指定为 的属性 BeginStoryboard

使用 Compose HandoffBehavior

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

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

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

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

适用于

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

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

注解

大多数典型的动画方案不使用此方法。 通常,在标记中创建 StoryboardBeginStoryboard 元素,然后将这些元素作为 EventTrigger 内容放在元素上。 由 事件触发时,动画随后运行。 的大多数控件方面 Storyboard 都可以通过标记中公开的属性来解决。

对于不使用 isControllable、 参数的签名,或者在指定false了该参数时,一旦动画达到“填充”周期,就会删除与动画关联的时间线时钟。 因此,动画在运行一次后无法重启。 控制动画还要求情节提要具有 x:Name 指令 或通过代码中的引用访问。

交接行为可以指定为 的属性 BeginStoryboard

使用 Compose HandoffBehavior

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

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

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

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

适用于