FrameworkContentElement.BeginStoryboard 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
开始所提供的演示图板中包含的操作序列。
重载
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。
此动画问题主要出现在生存期较长的对象上。 对对象进行垃圾回收时,其时钟也会断开连接并回收垃圾。
有关时钟对象的详细信息,请参阅动画和计时系统概述。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈