RemoveStoryboard 类

定义

命名空间:

System.Windows.Media.Animation

程序集:

PresentationFramework.dll

一个移除 Storyboard 的触发器操作。

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 事件上的情节提要。

构造函数

RemoveStoryboard()

初始化 RemoveStoryboard 类的新实例。

属性

BeginStoryboardName	获取或设置将你想要的 Storyboard 启动为交互式控制的 BeginStoryboard 的 Name。 (继承自 ControllableStoryboardAction)
DependencyObjectType	获取 DependencyObjectType 包装此实例的 CLR 类型的 。 (继承自 DependencyObject)
Dispatcher	获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject)
IsSealed	获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject)

方法

CheckAccess()	确定调用线程是否可以访问此 DispatcherObject。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。 要清除的属性由 DependencyPropertyKey 指定。 (继承自 DependencyObject)
CoerceValue(DependencyProperty)	对指定依赖属性的值进行强制。 通过对调用方 DependencyObject 上存在的依赖属性的属性元数据中所指定的任何 CoerceValueCallback 函数进行调用来完成此操作。 (继承自 DependencyObject)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
GetHashCode()	获取此 DependencyObject 的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用的枚举数，用于确定哪些依赖项属性在此 DependencyObject 上具有以本地方式设置的值。 (继承自 DependencyObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	对 DependencyObject 的此实例返回依赖属性的当前有效值。 (继承自 DependencyObject)
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	每当更新此 DependencyObject 的任何依赖属性的有效值时调用。 更改的特定依赖属性将在事件数据中报告。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果存在，则返回依赖属性的本地值。 (继承自 DependencyObject)
SetCurrentValue(DependencyProperty, Object)	设置依赖属性的值而不更改其值源。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，该值由其依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置一个只读依赖属性的本地值，该值由依赖属性的 DependencyPropertyKey 标识符指定。 (继承自 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
VerifyAccess()	强制调用线程具有此 DispatcherObject 的访问权限。 (继承自 DispatcherObject)

另请参阅

• EventTrigger