Storyboard クラス

定義

子アニメーションのオブジェクトやプロパティの対象化情報を提供するコンテナ タイムライン。

public ref class Storyboard : System::Windows::Media::Animation::ParallelTimeline
public class Storyboard : System.Windows.Media.Animation.ParallelTimeline
type Storyboard = class
    inherit ParallelTimeline
Public Class Storyboard
Inherits ParallelTimeline
継承

注釈

ストーリーボードを対話的に制御する

制御可能なストーリーボードは、一時停止、再開、シーク、停止、および削除できます。 ストーリーボードをマークアップで制御できるようにするには、それを作成するオブジェクトの プロパティをBeginStoryboard指定Nameします。たとえば、「方法: 開始後にイベント トリガーを使用してストーリーボードを制御する」を参照してください。 コードでストーリーボードを制御できるようにするには、ストーリーボード Begin の メソッドの適切なオーバーロードを使用し、 を指定 true して制御できるようにする必要があります。 例については、「 方法: 開始後にストーリーボードを制御する」を参照してください。

データ バインディングとタイムラインのアニメーション化

ほとんどのタイムラインプロパティは、データ バインドまたはアニメーション化できます。ただし、タイミング システムの動作方法により、データ バインドまたはアニメーション化されたタイムラインは、他のデータ バインドオブジェクトやアニメーション化されたオブジェクトと同様に動作しません。 その動作を理解するには、タイムラインをアクティブ化することが何を意味するのかを理解するのに役立ちます。

タイムラインがアクティブになると、コピーはタイムラインとその子タイムラインで作成されます。 これらのコピーは固定され (読み取り専用になります)、それらから Clock オブジェクトが作成されます。 これらのクロックは、ターゲット プロパティをアニメーション化する実際の作業を実行します。 タイムラインがデータバインドまたはアニメーション化されている場合、クロックの作成時に現在の値のスナップショットが作成されます。 元のタイムラインは変更され続ける可能性がありますが、そのクロックは変わりません。

タイムラインがデータ バインディングまたはアニメーションの変更を反映するには、そのクロックを再作成する必要があります。 クロックは自動的に再作成されません。 タイムラインの変更を適用するいくつかの方法を次に示します。

  • タイムラインが Storyboard であるか、それに属している場合は、BeginStoryboard または Begin メソッドを使用してストーリーボードを再適用することで、変更を反映させることができます。 これには、アニメーションが再起動されるという副作用があります。 コードでは、Seek メソッドを使用して、ストーリーボードを前の位置に戻すことができます。

  • BeginAnimation メソッドを使用してプロパティにアニメーションを直接適用した場合は、もう一度 BeginAnimation メソッドを呼び出して、変更されたアニメーションを渡します。

  • クロック レベルで直接作業している場合は、新しいクロック セットを作成して適用し、それらを使用して、作成したクロックの以前のセットを置き換えます。

データ バインド アニメーションの例については、「 キー スプライン アニメーションのサンプル 」を参照してください。

コンストラクター

Storyboard()

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

フィールド

TargetNameProperty

TargetName 添付プロパティを識別します。

TargetProperty

Target 添付プロパティを識別します。

TargetPropertyProperty

TargetProperty 添付プロパティを識別します。

プロパティ

AccelerationRatio

時間の経過を 0 から最大速度に加速する場合に、費やされるタイムラインの Duration の比率を指定する値を取得または設定します。

(継承元 Timeline)
AutoReverse

順方向の反復の完了後に、タイムラインを逆方向に再生するかどうかを示す値を取得または設定します。

(継承元 Timeline)
BeginTime

この Timeline を開始する時間を取得または設定します。

(継承元 Timeline)
CanFreeze

オブジェクトを変更不可能にできるかどうかを示す値を取得します。

(継承元 Freezable)
Children

TimelineGroup の直接の子 Timeline オブジェクトのコレクションを取得または設定します。

(継承元 TimelineGroup)
DecelerationRatio

時間の経過を最大速度から 0 に減速する場合に、費やされるタイムラインの Duration の比率を指定する値を取得または設定します。

(継承元 Timeline)
DependencyObjectType

このインスタンスの DependencyObjectType CLR 型をラップする を取得します。

(継承元 DependencyObject)
Dispatcher

この Dispatcher が関連付けられている DispatcherObject を取得します。

(継承元 DispatcherObject)
Duration

繰り返しをカウントせずに、このタイムラインの再生に要する時間を取得または設定します。

(継承元 Timeline)
FillBehavior

アクティブ期間の終わりに達した後の Timeline の動作を指定する値を取得または設定します。

(継承元 Timeline)
HasAnimatedProperties

1 つ以上の AnimationClock オブジェクトが、このオブジェクトの任意の依存関係プロパティに関連付けられているかどうかを示す値を取得または設定します。

(継承元 Animatable)
IsFrozen

オブジェクトが変更可能かどうかを示す値を取得します。

(継承元 Freezable)
IsSealed

このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。

(継承元 DependencyObject)
Name

この Timeline の名前を取得または設定します。

(継承元 Timeline)
RepeatBehavior

このタイムラインの繰り返し動作を取得または設定します。

(継承元 Timeline)
SlipBehavior

タイムラインの 1 つ以上の Timeline 子がずれた場合、このタイムラインの動作を指定する値を取得または設定します。

(継承元 ParallelTimeline)
SpeedRatio

この Timeline の時間の進行の速度 (親に対する相対的な速度) を取得または設定します。

(継承元 Timeline)

添付プロパティ

Target

アニメーション化するオブジェクトを取得または設定します。

TargetName

アニメーション化するオブジェクトの名前を取得または設定します。 オブジェクトは FrameworkElementFrameworkContentElement、または Freezable である必要があります。

TargetProperty

子アニメーションのオブジェクトやプロパティの対象化情報を提供するコンテナ タイムライン。

メソッド

AddChild(Object)

Timeline をこの TimelineGroup に追加します。

(継承元 TimelineGroup)
AddText(String)

この Timeline の子としてテキスト文字列を追加します。

(継承元 TimelineGroup)
AllocateClock()

このタイムラインの型固有のクロックを作成します。

(継承元 TimelineGroup)
ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock を指定した DependencyProperty に適用します。 プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。

(継承元 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock を指定した DependencyProperty に適用します。 プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。

(継承元 Animatable)
Begin()

この Storyboard に関連付けられているアニメーションをターゲットに適用して開始します。

Begin(FrameworkContentElement)

この Storyboard に関連付けられているアニメーションをターゲットに適用して開始します。

Begin(FrameworkContentElement, Boolean)

この Storyboard に関連付けられているアニメーションをターゲットに適用して開始します。

Begin(FrameworkContentElement, HandoffBehavior)

指定した Storyboard を使用して、この HandoffBehavior に関連付けられているアニメーションを対象に適用して開始します。

Begin(FrameworkContentElement, HandoffBehavior, Boolean)

指定した Storyboard を使用して、この HandoffBehavior に関連付けられているアニメーションを対象に適用して開始します。

Begin(FrameworkElement)

この Storyboard に関連付けられているアニメーションをターゲットに適用して開始します。

Begin(FrameworkElement, Boolean)

この Storyboard に関連付けられているアニメーションをターゲットに適用して開始します。

Begin(FrameworkElement, FrameworkTemplate)

この Storyboard に関連付けられているアニメーションを、指定したテンプレート内の対象に適用して開始します。

Begin(FrameworkElement, FrameworkTemplate, Boolean)

この Storyboard に関連付けられているアニメーションを、指定したテンプレート内の対象に適用して開始します。

Begin(FrameworkElement, FrameworkTemplate, HandoffBehavior)

この Storyboard に関連付けられているアニメーションを、指定したテンプレート内の対象に適用して開始します。

Begin(FrameworkElement, FrameworkTemplate, HandoffBehavior, Boolean)

この Storyboard に関連付けられているアニメーションを、指定したテンプレート内の対象に適用して開始します。

Begin(FrameworkElement, HandoffBehavior)

指定した Storyboard を使用して、この HandoffBehavior に関連付けられているアニメーションを対象に適用して開始します。

Begin(FrameworkElement, HandoffBehavior, Boolean)

この Storyboard に関連付けられているアニメーションをターゲットに適用して開始します。

BeginAnimation(DependencyProperty, AnimationTimeline)

指定された DependencyProperty にアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定されたプロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。

(継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

指定された DependencyProperty にアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。

(継承元 Animatable)
CheckAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。

(継承元 DispatcherObject)
ClearValue(DependencyProperty)

プロパティのローカル値をクリアします。 クリアするプロパティは DependencyProperty 識別子で指定されます。

(継承元 DependencyObject)
ClearValue(DependencyPropertyKey)

読み取り専用プロパティのローカル値を消去します。 消去するプロパティは、DependencyPropertyKey で指定します。

(継承元 DependencyObject)
Clone()

この Storyboard の変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 このメソッドは、依存関係プロパティをコピーするときにリソース参照とデータ バインディングをコピーしますが (ただし、これらは解決されなくなる場合があります)、アニメーションやその現在の値はコピーしません。

CloneCore(Freezable)

基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを、指定した Freezable の複製 (詳細コピー) にします。

(継承元 Freezable)
CloneCurrentValue()

この ParallelTimeline オブジェクトの変更可能な複製を作成し、このオブジェクトの現在値の詳細コピーを作成します。 リソース参照、データ バインディング、アニメーションはコピーされませんが、それらの現在値はコピーされます。

(継承元 ParallelTimeline)
CloneCurrentValueCore(Freezable)

現在のプロパティ値を使用して、インスタンスを、指定した Freezable の変更可能な複製 (詳細コピー) にします。

(継承元 Freezable)
CoerceValue(DependencyProperty)

指定した依存関係プロパティの値を強制します。 これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。

(継承元 DependencyObject)
CreateClock()

このインスタンスを使用して、新しい ClockGroup オブジェクトをインスタンス化します。

(継承元 TimelineGroup)
CreateClock(Boolean)

この Clock から新しい Timeline を作成し、その新しい Clock が制御可能かどうかを指定します。 この Timeline に子がある場合は、この Timeline をルートにしてクロックのツリーが作成されます。

(継承元 Timeline)
CreateInstance()

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

(継承元 Freezable)
CreateInstanceCore()

Storyboard クラスの新しいインスタンスを作成します。

Equals(Object)

指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。

(継承元 DependencyObject)
Freeze()

現在のオブジェクトを変更不可能にし、その IsFrozen プロパティを true に設定します。

(継承元 Freezable)
FreezeCore(Boolean)

この Timeline を変更不可能な状態にするか、変更不可能な状態にできるかどうかを判断します。

(継承元 Timeline)
GetAnimationBaseValue(DependencyProperty)

指定した DependencyProperty のアニメーション化されていない値を返します。

(継承元 Animatable)
GetAsFrozen()

基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の 固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。

(継承元 Freezable)
GetAsFrozenCore(Freezable)

このインスタンスを、指定した Timeline オブジェクトの複製にします。

(継承元 Timeline)
GetCurrentGlobalSpeed()

この CurrentGlobalSpeed 用に作成された ClockStoryboard を取得します。

GetCurrentGlobalSpeed(FrameworkContentElement)

この CurrentGlobalSpeed 用に作成された ClockStoryboard を取得します。

GetCurrentGlobalSpeed(FrameworkElement)

この CurrentGlobalSpeed 用に作成された ClockStoryboard を取得します。

GetCurrentIteration()

この CurrentIteration 用に作成された ClockStoryboard を取得します。

GetCurrentIteration(FrameworkContentElement)

この CurrentIteration 用に作成された ClockStoryboard を取得します。

GetCurrentIteration(FrameworkElement)

この CurrentIteration 用に作成された ClockStoryboard を取得します。

GetCurrentProgress()

この CurrentProgress 用に作成された ClockStoryboard を取得します。

GetCurrentProgress(FrameworkContentElement)

この CurrentProgress 用に作成された ClockStoryboard を取得します。

GetCurrentProgress(FrameworkElement)

この CurrentProgress 用に作成された ClockStoryboard を取得します。

GetCurrentState()

この CurrentState 用に作成された ClockStoryboard を取得します。

GetCurrentState(FrameworkContentElement)

この CurrentState 用に作成された ClockStoryboard を取得します。

GetCurrentState(FrameworkElement)

この CurrentState 用に作成された ClockStoryboard を取得します。

GetCurrentTime()

この CurrentTime 用に作成された ClockStoryboard を取得します。

GetCurrentTime(FrameworkContentElement)

この CurrentTime 用に作成された ClockStoryboard を取得します。

GetCurrentTime(FrameworkElement)

この CurrentTime 用に作成された ClockStoryboard を取得します。

GetCurrentValueAsFrozen()

現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。

(継承元 Freezable)
GetCurrentValueAsFrozenCore(Freezable)

このインスタンスを、指定された Timeline の凍結された複製にします。 リソース参照、データ バインディング、アニメーションはコピーされませんが、それらの現在値はコピーされます。

(継承元 Timeline)
GetHashCode()

この DependencyObject のハッシュ コードを取得します。

(継承元 DependencyObject)
GetIsPaused()

この Clock 用に作成された Storyboard が一時停止しているかどうかを示す値を取得します。

GetIsPaused(FrameworkContentElement)

この Clock 用に作成された Storyboard が一時停止しているかどうかを示す値を取得します。

GetIsPaused(FrameworkElement)

この Clock 用に作成された Storyboard が一時停止しているかどうかを示す値を取得します。

GetLocalValueEnumerator()

どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。

(継承元 DependencyObject)
GetNaturalDuration(Clock)

この Timeline の 1 回の反復の長さを返します。

(継承元 Timeline)
GetNaturalDurationCore(Clock)

指定した Clock から自然な継続時間 (1 回の反復の継続時間) を返します。

(継承元 ParallelTimeline)
GetTarget(DependencyObject)

指定した TargetTimeline 値を取得します。

GetTargetName(DependencyObject)

指定した TargetNameTimeline 値を取得します。

GetTargetProperty(DependencyObject)

指定した TargetPropertyTimeline 値を取得します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetValue(DependencyProperty)

DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。

(継承元 DependencyObject)
InvalidateProperty(DependencyProperty)

指定した依存関係プロパティの有効値を再評価します。

(継承元 DependencyObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnChanged()

現在の Freezable オブジェクトの変更時に呼び出されます。

(継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

設定されたばかりの DependencyObjectType データ メンバーに対して、適切なコンテキスト ポインターが確立されていることを確認します。

(継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

(継承元 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

OnPropertyChanged(DependencyPropertyChangedEventArgs)DependencyObject 実装をオーバーライドして、さらに型 Freezable の変化する依存関係プロパティへの応答として任意の Changed ハンドラーも呼び出します。

(継承元 Freezable)
Pause()

この Clock 用に作成された Storyboard を一時停止します。

Pause(FrameworkContentElement)

この Storyboard に関連付けられている、指定された FrameworkContentElementClock を一時停止します。

Pause(FrameworkElement)

この Storyboard に関連付けられている、指定された FrameworkElementClock を一時停止します。

ReadLocalValue(DependencyProperty)

ローカルの依存関係プロパティの値を返します (存在する場合)。

(継承元 DependencyObject)
ReadPreamble()

Freezable が有効なスレッドからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータ メンバーを読み取る任意の API の開始時に、このメソッドを呼び出す必要があります。

(継承元 Freezable)
Remove()

この Storyboard 用に作成された Clock オブジェクトを削除します。 この Storyboard に属するアニメーションは、いったんアニメーション化された後は、FillBehavior の設定には関係なく、このプロパティに影響しなくなります。

Remove(FrameworkContentElement)

この Storyboard 用に作成された Clock オブジェクトを削除します。 この Storyboard に属するアニメーションは、いったんアニメーション化された後は、FillBehavior の設定には関係なく、このプロパティに影響しなくなります。

Remove(FrameworkElement)

この Storyboard 用に作成された Clock オブジェクトを削除します。 この Storyboard に属するアニメーションは、いったんアニメーション化された後は、FillBehavior の設定には関係なく、このプロパティに影響しなくなります。

Resume()

この Storyboard のために作成された Clock を再開します。

Resume(FrameworkContentElement)

この Storyboard のために作成された Clock を再開します。

Resume(FrameworkElement)

この Storyboard のために作成された Clock を再開します。

Seek(FrameworkContentElement, TimeSpan, TimeSeekOrigin)

この Storyboard を指定した位置までシークします。 Storyboard は、クロックが次の目盛りを刻んだときに、要求されたシークを実行します。

Seek(FrameworkElement, TimeSpan, TimeSeekOrigin)

この Storyboard を指定した位置までシークします。 Storyboard は、クロックが次の目盛りを刻んだときに、要求されたシークを実行します。

Seek(TimeSpan)

この Storyboard を指定した位置までシークします。 Storyboard は、クロックが次の目盛りを刻んだときに、要求されたシークを実行します。

Seek(TimeSpan, TimeSeekOrigin)

この Storyboard を指定した位置までシークします。 Storyboard は、クロックが次の目盛りを刻んだときに、要求されたシークを実行します。

SeekAlignedToLastTick(FrameworkContentElement, TimeSpan, TimeSeekOrigin)

この Storyboard を新しい位置まで即座 (同期的) にシークします。

SeekAlignedToLastTick(FrameworkElement, TimeSpan, TimeSeekOrigin)

この Storyboard を新しい位置まで即座 (同期的) にシークします。

SeekAlignedToLastTick(TimeSpan)

この Storyboard を新しい位置まで即座 (同期的) にシークします。

SeekAlignedToLastTick(TimeSpan, TimeSeekOrigin)

この Storyboard を新しい位置まで即座 (同期的) にシークします。

SetCurrentValue(DependencyProperty, Object)

依存関係プロパティ値のソースを変更せずにその値を設定します。

(継承元 DependencyObject)
SetSpeedRatio(Double)

この Clock 用に作成された Storyboard の対話的速度比率を設定します。

SetSpeedRatio(FrameworkContentElement, Double)

この Storyboard 用に作成された Clock の対話型速度比を設定します。

SetSpeedRatio(FrameworkElement, Double)

この Storyboard 用に作成された Clock の対話型速度比を設定します。

SetTarget(DependencyObject, DependencyObject)

指定した Timeline が、依存関係オブジェクトを対象にするように指定します。

SetTargetName(DependencyObject, String)

指定した Timeline が指定した名前の依存関係オブジェクトを対象とするように指定します。

SetTargetProperty(DependencyObject, PropertyPath)

指定した Timeline が、指定した依存関係プロパティを対象にするようにします。

SetValue(DependencyProperty, Object)

依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。

(継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)

依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。

(継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)

シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。

(継承元 DependencyObject)
SkipToFill()

このストーリーボードの Clock の現在の時間をそのアクティブな期間の終わりに進めます。

SkipToFill(FrameworkContentElement)

このストーリーボードの Clock の現在の時間をそのアクティブな期間の終わりに進めます。

SkipToFill(FrameworkElement)

このストーリーボードの Clock の現在の時間をそのアクティブな期間の終わりに進めます。

Stop()

この Storyboard のために作成された Clock を停止します。

Stop(FrameworkContentElement)

この Storyboard のために作成された Clock を停止します。

Stop(FrameworkElement)

この Storyboard のために作成された Clock を停止します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
VerifyAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。

(継承元 DispatcherObject)
WritePostscript()

FreezableChanged イベントを発生させ、その OnChanged() メソッドを呼び出します。 Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更するすべての API の終了時に、このメソッドを呼び出す必要があります。

(継承元 Freezable)
WritePreamble()

Freezable が固定されておらず、有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータ メンバーに書き込む任意の API の開始時に、このメソッドを呼び出す必要があります。

(継承元 Freezable)

イベント

Changed

Freezable、またはこれに含まれているオブジェクトが変更されると発生します。

(継承元 Freezable)
Completed

このタイムラインの再生が完全に終了したときに発生します。このタイムラインは、もうアクティブ期間に入りません。

(継承元 Timeline)
CurrentGlobalSpeedInvalidated

タイムラインのクロックの時間の進行の速度が変化すると発生します。

(継承元 Timeline)
CurrentStateInvalidated

タイムラインの ClockCurrentState プロパティが更新されたときに発生します。

(継承元 Timeline)
CurrentTimeInvalidated

タイムラインの ClockCurrentTime プロパティが更新されたときに発生します。

(継承元 Timeline)
RemoveRequested

このタイムラインのために作成されたクロックか、親タイムラインのクロックが削除された場合に発生します。

(継承元 Timeline)

明示的なインターフェイスの実装

IAddChild.AddChild(Object)

子オブジェクトを追加します。

(継承元 TimelineGroup)
IAddChild.AddText(String)

オブジェクトにノードのテキスト コンテンツを追加します。

(継承元 TimelineGroup)

適用対象