RemoveStoryboard クラス

定義

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
継承

次の例では、ユーザーが含まれているページから移動したときに、a 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設定し、オブジェクト (たとえばPauseStoryboardResumeStoryboard、またはStopStoryboard) を使用ControllableStoryboardActionして、そのNameプロパティを参照して制御します。 指定NameBeginStoryboardされていない場合は、Storyboard開始後に対話形式で制御することはできません。 詳細については、「 方法: 開始後にイベント トリガーを使用してストーリーボードを制御 する」を参照してください。

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

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

コンストラクター

RemoveStoryboard()

RemoveStoryboard クラスの新しいインスタンスを初期化します。

プロパティ

BeginStoryboardName

対話的に制御する Storyboard を開始した BeginStoryboardName を取得または設定します。

(継承元 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)

適用対象

こちらもご覧ください