Timeline クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
時間のセグメントを定義します。
public ref class Timeline abstract : System::Windows::Media::Animation::Animatable[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public abstract class Timeline : System.Windows.Media.Animation.Animatable[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type Timeline = class
inherit AnimatablePublic MustInherit Class Timeline
Inherits Animatable- 継承
- 派生
- 属性
注釈
タイムラインは、時間のセグメントを表します。 このプロパティを使用すると、そのセグメントの長さ、開始するタイミング、繰り返す回数、そのセグメントでの時間の進行状況などを指定できます。
タイムライン クラスから継承するクラスは、アニメーションやメディア再生などの追加機能を提供します。 使用できる特殊なタイムラインの種類の一部の例を次に示します。
アニメーション: AnimationTimeline は、出力値を生成するタイムラインの一種です。 アニメーションをプロパティに関連付けると、アニメーションは再生中にプロパティの値を更新し、"アニメーション化" します。 アニメーションの概要については、「 アニメーションの概要」を参照してください。 アニメーションを適用するさまざまな方法については、「 プロパティ アニメーション手法の概要」を参照してください。
MediaTimelines: MediaTimeline は、メディア ファイルの再生を制御するタイムラインの一種です。
ParallelTimelines: ParallelTimeline は、他のタイムラインをグループ化するタイムラインの一種です。
ストーリーボード: Storyboard は、含まれるタイムラインのオブジェクトとプロパティのターゲット情報を提供する特殊な種類の ParallelTimeline です。 Storyboard オブジェクトの詳細については、「ストーリーボードの概要」を参照してください。
タイムラインの使用の詳細については、「 アニメーションの概要」を参照してください。 タイムラインのタイミング機能の概要については、「 タイミング動作の概要」を参照してください。
データ バインディングとタイムラインのアニメーション化
ほとんどのタイムライン プロパティは、データ バインドまたはアニメーション化できます。ただし、タイミング システムの動作が原因で、データ バインドまたはアニメーション化されたタイムラインは、他のデータ バインドやアニメーション化されたオブジェクトと同様に動作しません。 その動作を理解するには、タイムラインをアクティブ化する意味を理解するのに役立ちます。
タイムラインが適用されると、コピーはタイムラインとその子タイムラインで作成されます。 これらのコピーは固定 (読み取り専用) され、 Clock オブジェクトが作成されます。 これらの時計は、対象となるプロパティをアニメーション化する実際の作業を行います。 タイムラインがデータ バインドまたはアニメーション化されている場合、そのクロックの作成時に現在の値のスナップショットが作成されました。 元のタイムラインは変わり続ける可能性がありますが、そのクロックは変わりません。
タイムラインでデータ バインディングまたはアニメーションの変更を反映するには、そのクロックを再生成する必要があります。 クロックはあなたのために自動的に再生成されることはありません。 タイムラインの変更を適用する方法を次に示します。
タイムラインが Storyboardであるか、またはに属している場合は、 BeginStoryboard または Begin メソッドを使用してストーリーボードを再適用することで、変更を反映させることができます。 これは、アニメーションを再起動する副作用もあります。 コードでは、 Seek メソッドを使用してストーリーボードを前の位置に戻すことができます。
BeginAnimation メソッドを使用してプロパティにアニメーションを直接適用した場合は、BeginAnimation メソッドをもう一度呼び出し、変更されたアニメーションを渡します。
クロック レベルで直接作業している場合は、新しいクロック セットを作成して適用し、それらを使用して、生成された以前のクロック セットを置き換えます。
データ バインド アニメーションの例については、 キー スプライン アニメーションのサンプル を参照してください。
タイムラインをタイマーとして使用する
タイムラインの時計は、イベント ハンドラーが関連付けられている場合、または ( AnimationClock オブジェクトの場合) プロパティに関連付けられている場合にのみ進行します。 このため 、タイマーとして Timeline を使用することはお勧めしません。
コンストラクター
| 名前 | 説明 |
|---|---|
| Timeline() |
Timeline クラスの新しいインスタンスを初期化します。 |
| Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior) |
指定したTimeline、BeginTime、およびDurationを使用して、RepeatBehavior クラスの新しいインスタンスを初期化します。 |
| Timeline(Nullable<TimeSpan>, Duration) | |
| Timeline(Nullable<TimeSpan>) |
フィールド
| 名前 | 説明 |
|---|---|
| AccelerationRatioProperty |
AccelerationRatio依存関係プロパティを識別します。 |
| AutoReverseProperty |
AutoReverse依存関係プロパティを識別します。 |
| BeginTimeProperty |
BeginTime依存関係プロパティを識別します。 |
| DecelerationRatioProperty |
DecelerationRatio依存関係プロパティを識別します。 |
| DesiredFrameRateProperty |
DesiredFrameRate添付プロパティを識別します。 |
| DurationProperty |
Duration依存関係プロパティを識別します。 |
| FillBehaviorProperty |
FillBehavior依存関係プロパティを識別します。 |
| NameProperty |
Name依存関係プロパティを識別します。 |
| RepeatBehaviorProperty |
RepeatBehavior依存関係プロパティを識別します。 |
| SpeedRatioProperty |
SpeedRatio依存関係プロパティを識別します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AccelerationRatio |
タイムラインの Duration 時間の経過をゼロから最大レートに加速するのに費やした割合を指定する値を取得または設定します。 |
| AutoReverse |
タイムラインが前方反復を完了した後に反転再生されるかどうかを示す値を取得または設定します。 |
| BeginTime |
この Timeline を開始する時刻を取得または設定します。 |
| CanFreeze |
オブジェクトを変更不可にできるかどうかを示す値を取得します。 (継承元 Freezable) |
| DecelerationRatio |
タイムラインの Duration 時間の経過を最大レートから 0 に減速するのに費やした割合を指定する値を取得または設定します。 |
| DependencyObjectType |
このインスタンスの CLR 型をラップする DependencyObjectType を取得します。 (継承元 DependencyObject) |
| Dispatcher |
このDispatcherが関連付けられているDispatcherObjectを取得します。 (継承元 DispatcherObject) |
| Duration |
繰り返しをカウントせず、このタイムラインが再生される時間の長さを取得または設定します。 |
| FillBehavior |
アクティブ期間の終わりに達した後の Timeline の動作を指定する値を取得または設定します。 |
| HasAnimatedProperties |
1 つ以上の AnimationClock オブジェクトがこのオブジェクトの依存関係プロパティのいずれかに関連付けられているかどうかを示す値を取得します。 (継承元 Animatable) |
| IsFrozen |
オブジェクトが現在変更可能かどうかを示す値を取得します。 (継承元 Freezable) |
| IsSealed |
このインスタンスが現在シールされているかどうかを示す値を取得します (読み取り専用)。 (継承元 DependencyObject) |
| Name |
この Timelineの名前を取得または設定します。 |
| RepeatBehavior |
このタイムラインの繰り返し動作を取得または設定します。 |
| SpeedRatio |
親に対する相対的な速度を取得または設定します。この Timelineの進行状況を示します。 |
添付プロパティ
| 名前 | 説明 |
|---|---|
| DesiredFrameRate |
このタイムラインとその子タイムラインの目的のフレーム レートを取得または設定します。 |
メソッド
| 名前 | 説明 |
|---|---|
| AllocateClock() | |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
指定したAnimationClockにDependencyPropertyを適用します。 プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
指定したAnimationClockにDependencyPropertyを適用します。 プロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
指定した DependencyPropertyにアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
指定した DependencyPropertyにアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable) |
| CheckAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。 (継承元 DispatcherObject) |
| ClearValue(DependencyProperty) |
プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyProperty 識別子によって指定されます。 (継承元 DependencyObject) |
| ClearValue(DependencyPropertyKey) |
読み取り専用プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyPropertyKeyによって指定されます。 (継承元 DependencyObject) |
| Clone() |
この Timelineの変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 |
| CloneCore(Freezable) |
基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを指定した Freezable の複製 (ディープ コピー) にします。 (継承元 Freezable) |
| CloneCurrentValue() |
この Timeline オブジェクトの変更可能な複製を作成し、このオブジェクトの現在の値の詳細コピーを作成します。 |
| CloneCurrentValueCore(Freezable) |
現在のプロパティ値を使用して、インスタンスを指定した Freezable の変更可能な複製 (ディープ コピー) にします。 (継承元 Freezable) |
| CoerceValue(DependencyProperty) |
指定した依存関係プロパティの値を強制します。 これは、呼び出し元のCoerceValueCallbackに存在する依存関係プロパティのプロパティ メタデータで指定されたDependencyObject関数を呼び出すことによって実現されます。 (継承元 DependencyObject) |
| CreateClock() |
このTimelineから、制御可能な新しいClockを作成します。 この Timeline に子がある場合は、この Timeline をルートとして使用してクロックのツリーが作成されます。 |
| CreateClock(Boolean) |
このClockから新しいTimelineを作成し、新しいClockを制御できるかどうかを指定します。 この Timeline に子がある場合は、この Timeline をルートとして使用してクロックのツリーが作成されます。 |
| CreateInstance() |
Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable) |
| CreateInstanceCore() |
派生クラスで実装された場合は、 Freezable 派生クラスの新しいインスタンスを作成します。 (継承元 Freezable) |
| Equals(Object) |
指定された DependencyObject が現在の DependencyObjectと等しいかどうかを判断します。 (継承元 DependencyObject) |
| Freeze() |
現在のオブジェクトを変更不可にし、その IsFrozen プロパティを |
| FreezeCore(Boolean) |
この Timeline を変更不可にするか、変更不可にできるかどうかを判断します。 |
| GetAnimationBaseValue(DependencyProperty) |
指定した DependencyPropertyのアニメーション化されていない値を返します。 (継承元 Animatable) |
| GetAsFrozen() |
基本 (アニメーション化されていない) プロパティ値を使用して、 Freezableの固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetAsFrozenCore(Freezable) |
このインスタンスを、指定した Timeline オブジェクトの複製にします。 |
| GetCurrentValueAsFrozen() |
現在のプロパティ値を使用して、 Freezable の固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
このインスタンスを、指定した Timelineの固定された複製にします。 リソース参照、データ バインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 |
| GetDesiredFrameRate(Timeline) |
指定した Timelineの目的のフレーム レートを取得します。 |
| GetHashCode() |
この DependencyObjectのハッシュ コードを取得します。 (継承元 DependencyObject) |
| GetLocalValueEnumerator() |
この DependencyObjectでローカルに値が設定されている依存関係プロパティを決定するための特殊な列挙子を作成します。 (継承元 DependencyObject) |
| GetNaturalDuration(Clock) |
この Timelineの 1 回の反復の長さを返します。 |
| GetNaturalDurationCore(Clock) |
この Timelineの 1 回の反復の長さを返します。 このメソッドは、 GetNaturalDuration(Clock)の実装を提供します。 |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| GetValue(DependencyProperty) |
DependencyObjectのこのインスタンスの依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject) |
| InvalidateProperty(DependencyProperty) |
指定した依存関係プロパティの有効な値を再評価します。 (継承元 DependencyObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| OnChanged() |
現在の Freezable オブジェクトが変更されたときに呼び出されます。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
設定したばかりの DependencyObjectType データ メンバーに対して適切なコンテキスト ポインターが確立されるようにします。 (継承元 Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
DependencyObjectのOnPropertyChanged(DependencyPropertyChangedEventArgs)実装をオーバーライドして、Changed型の依存関係プロパティの変化に応じてFreezable ハンドラーも呼び出します。 (継承元 Freezable) |
| ReadLocalValue(DependencyProperty) |
依存関係プロパティが存在する場合は、そのローカル値を返します。 (継承元 DependencyObject) |
| ReadPreamble() |
Freezableが有効なスレッドからアクセスされていることを確認します。 Freezableの継承子は、依存関係プロパティではないデータ メンバーを読み取る API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
値ソースを変更せずに依存関係プロパティの値を設定します。 (継承元 DependencyObject) |
| SetDesiredFrameRate(Timeline, Nullable<Int32>) |
指定した Timelineの目的のフレーム レートを設定します。 |
| SetValue(DependencyProperty, Object) |
依存関係プロパティ識別子で指定された依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
依存関係プロパティの DependencyPropertyKey 識別子で指定された、読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
シリアル化プロセスが指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
| VerifyAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。 (継承元 DispatcherObject) |
| WritePostscript() |
ChangedのFreezable イベントを発生させ、そのOnChanged() メソッドを呼び出します。 Freezableから派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更する API の末尾でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| WritePreamble() |
Freezableが固定されていないこと、および有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable 継承子は、依存関係プロパティではないデータ メンバーに書き込む API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
イベント
| 名前 | 説明 |
|---|---|
| Changed |
Freezableまたはそれに含まれるオブジェクトが変更されたときに発生します。 (継承元 Freezable) |
| Completed |
このタイムラインの再生が完全に完了すると発生します。アクティブな期間は入力されなくなります。 |
| CurrentGlobalSpeedInvalidated |
タイムラインのクロックの進行率が変化したときに発生します。 |
| CurrentStateInvalidated |
タイムラインのCurrentStateのClock プロパティが更新されたときに発生します。 |
| CurrentTimeInvalidated |
タイムラインのCurrentTimeのClock プロパティが更新されたときに発生します。 |
| RemoveRequested |
このタイムラインに対して作成されたクロック、またはその親タイムラインの 1 つが削除されたときに発生します。 |
