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>

注釈

または と共EventTriggerに を使用RemoveStoryboardして、 を削除しますStoryboard。Trigger

ストーリーボードを対話形式で一時停止、再開、停止、削除、または制御する

を対話形式で一時停止、再開、削除、またはその他の方法で制御Storyboardできるようにするには、 の BeginStoryboard プロパティをName設定し、 オブジェクト (、ResumeStoryboard、または StopStoryboardなどPauseStoryboard) を使用ControllableStoryboardActionして、 をName参照して制御します。 の NameBeginStoryboard が指定されていない場合、開始後に を Storyboard 対話形式で制御することはできません。 詳細については、「 方法: 開始後にイベント トリガーを使用してストーリーボードを制御 する」を参照してください。

ストーリーボードを削除するタイミング

アクションを使用して、 RemoveStoryboard で始まるHandoffBehaviorComposeストーリーボードを削除する必要があります。 また、アニメーション化するオブジェクトが使用されなくなったときに、背景アニメーションを削除することをお勧めします。 たとえば、要素のイベントを使用して無期限に繰り返されるストーリーボードを適用する場合は、アクションを使用RemoveStoryboardして要素UnloadedのLoadedイベントのストーリーボードを削除する も作成EventTriggerする必要があります。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• EventTrigger