RemoveStoryboard 类

定义

public ref class RemoveStoryboard sealed : System::Windows::Media::Animation::ControllableStoryboardAction

public sealed class RemoveStoryboard : System.Windows.Media.Animation.ControllableStoryboardAction

type RemoveStoryboard = class
    inherit ControllableStoryboardAction

Public NotInheritable Class RemoveStoryboard
Inherits ControllableStoryboardAction

继承

Object

DispatcherObject

DependencyObject

TriggerAction

ControllableStoryboardAction

RemoveStoryboard

示例

以下示例演示如何删除 Storyboard ，以在用户导航离开包含 Storyboard的页面时阻止它继续。

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  Name="RootPage">
  <StackPanel>

    <!-- The MediaElement control plays the sound. -->
    <MediaElement Name="myMediaElement" />

    <Button Name="BeginButton">Begin</Button>

    <StackPanel.Triggers>

      <!-- This trigger causes the Storyboard to start (the music start) when you click the
           "BeginButton" button. -->
      <EventTrigger RoutedEvent="Button.Click" SourceName="BeginButton">
        <EventTrigger.Actions>
          <BeginStoryboard Name="myBeginStoryboard">
            <Storyboard>
              <MediaTimeline Source="C:\WINDOWS\Media\town.mid" Storyboard.TargetName="myMediaElement"  
               RepeatBehavior="Forever" />
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger.Actions>
      </EventTrigger>

      <!-- When this page unloads, like when you navigate away from the page, this
           trigger causes the Storyboard to be removed and the clock to stop. If 
           you come back to this page and click the button to start the Storyboard,
           the music starts from the beginning. Alternatively, if you don't unload 
           the Storyboard when you leave the page, the Storyboard does not stop while 
           you're gone and when you navigate back to the page you hear the music  
           continuing as though you had never left. -->
      <EventTrigger RoutedEvent="Page.Unloaded" >
        <EventTrigger.Actions>
          <RemoveStoryboard BeginStoryboardName="myBeginStoryboard" />
        </EventTrigger.Actions>
      </EventTrigger>
    </StackPanel.Triggers>
  </StackPanel>
</Page>

注解

将 与 或 一起使用RemoveStoryboardEventTrigger，以删除 Storyboard。Trigger

以交互方式暂停、恢复、停止、删除或以其他方式控制情节提要

为了能够以交互方式暂停、恢复、删除或以其他方式控制 ， Storyboard 请设置 Name 其 BeginStoryboard 的 属性，并使用 ControllableStoryboardAction 对象 (（如 PauseStoryboard、 ResumeStoryboard或 StopStoryboard) ）通过引用其 来控制它 Name。 Name如果未指定 的 BeginStoryboard ，则在Storyboard启动后无法以交互方式控制 。 有关详细信息 ，请参阅如何：在情节提要启动后使用事件触发器控制情节提要 。

何时删除情节提要

应使用 RemoveStoryboard 操作删除以 为 HandoffBehaviorCompose开头的任何情节提要。 当背景动画动画的对象不再被使用时，删除背景动画也是一个好主意。 例如，如果使用元素的事件 Loaded 应用无限重复的情节提要，则还应创建一个 EventTrigger ，该情节提要使用 RemoveStoryboard 操作删除元素 Unloaded 事件上的情节提要。

构造函数

属性

方法

适用于

另请参阅

• EventTrigger