SingleAnimation クラス

リファレンス

定義

名前空間:: System.Windows.Media.Animation

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した Duration に対する線形補間を使用して、2 つのターゲット値の間の Single プロパティの値をアニメーション化します。

public ref class SingleAnimation : System::Windows::Media::Animation::SingleAnimationBase

public class SingleAnimation : System.Windows.Media.Animation.SingleAnimationBase

type SingleAnimation = class
    inherit SingleAnimationBase

Public Class SingleAnimation
Inherits SingleAnimationBase

継承: Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

SingleAnimationBase
SingleAnimation

注釈

アニメーションは、一定期間にわたってプロパティの値を更新します。アニメーション効果は、少数のピクセルを左右に移動 Shape したり、オブジェクトを回転しながら元のサイズの 200 倍に拡大したり、色を変更したりするなど、微妙な場合があります。 Windows Presentation Foundation (WPF) でアニメーションを作成するには、アニメーションをオブジェクトのプロパティ値に関連付けます。

ターゲット値

クラスは SingleAnimation 、2 つのターゲット値間の遷移を作成します。ターゲット値を設定するには、、、およびプロパティをFrom To By使用します。次の表は、From、To、By の各プロパティを組み合わせて使用するか、個別に使用して、アニメーションのターゲット値を決定する方法をまとめたものです。

指定するプロパティ	結果として生じる動作
From	アニメーションは、From プロパティで指定した値から、アニメーション化対象のプロパティの基本値または前のアニメーションの出力値 (前のアニメーションの構成によります) まで進行します。
From および To	アニメーションは、From プロパティで指定した値から To プロパティで指定した値まで進行します。
From および By	アニメーションは、From プロパティで指定した値から、From プロパティと By プロパティの合計で指定した値まで進行します。
To	アニメーションは、アニメーション化対象のプロパティの基本値または前のアニメーションの出力値から、To プロパティで指定した値まで進行します。
By	アニメーションは、アニメーション化対象のプロパティの基本値または前のアニメーションの出力値から、その値と By プロパティで指定した値の合計まで進行します。

注意

プロパティと By プロパティの両方をTo設定するとTo、プロパティが優先され、 By プロパティは無視されます。

他の補間方法を使用したり、2 つ以上のターゲット値の間でアニメーション化したりするには、オブジェクトを SingleAnimationUsingKeyFrames 使用します。

複数のアニメーションを 1 つのプロパティに適用する方法については、「キーフレームアニメーションの概要」をご覧ください。

Freezable 機能

クラスは SingleAnimation からFreezable SingleAnimation継承されるため、オブジェクトには、リソースとして宣言したり、複数のオブジェクト間で共有したり、読み取り専用にしてパフォーマンスを向上させ、複製したり、スレッドセーフにしたりできる、いくつかの特別な機能があります。 Freezable オブジェクトで提供されるさまざまな機能について詳しくは、「Freezable オブジェクトの概要」をご覧ください。

コンストラクター

SingleAnimation()	SingleAnimation クラスの新しいインスタンスを初期化します。
SingleAnimation(Single, Duration)	指定された期間にわたって指定された値にアニメーションを付ける、SingleAnimation クラスの新しいインスタンスを初期化します。アニメーションの開始値は、アニメーションを付けるプロパティの基準値か、別のアニメーションからの出力になります。
SingleAnimation(Single, Duration, FillBehavior)	指定された期間にわたって指定された値までアニメーションを付け、指定された塗りつぶし動作がある、SingleAnimation クラスの新しいインスタンスを初期化します。アニメーションの開始値は、アニメーションを付けるプロパティの基準値か、別のアニメーションからの出力になります。
SingleAnimation(Single, Single, Duration)	指定した開始値から指定した宛先値まで、指定された期間にわたってアニメーションを付ける、SingleAnimation クラスの新しいインスタンスを初期化します。
SingleAnimation(Single, Single, Duration, FillBehavior)	指定した開始値から指定した宛先値まで、指定された期間にわたってアニメーションを付け、指定された塗りつぶし動作がある、SingleAnimation クラスの新しいインスタンスを初期化します。

フィールド

ByProperty	By 依存関係プロパティを識別します。
EasingFunctionProperty	EasingFunction 依存関係プロパティを識別します。
FromProperty	From 依存関係プロパティを識別します。
ToProperty	To 依存関係プロパティを識別します。

プロパティ

AccelerationRatio	時間の経過を 0 から最大速度に加速する場合に、費やされるタイムラインの Duration の比率を指定する値を取得または設定します。 (継承元 Timeline)
AutoReverse	順方向の反復の完了後に、タイムラインを逆方向に再生するかどうかを示す値を取得または設定します。 (継承元 Timeline)
BeginTime	この Timeline を開始する時間を取得または設定します。 (継承元 Timeline)
By	アニメーションの開始値の変化値の総量を取得または設定します。
CanFreeze	オブジェクトを変更不可能にできるかどうかを示す値を取得します。 (継承元 Freezable)
DecelerationRatio	時間の経過を最大速度から 0 に減速する場合に、費やされるタイムラインの Duration の比率を指定する値を取得または設定します。 (継承元 Timeline)
DependencyObjectType	このインスタンスの DependencyObjectType CLR 型をラップするを取得します。 (継承元 DependencyObject)
Dispatcher	この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject)
Duration	繰り返しをカウントせずに、このタイムラインの再生に要する時間を取得または設定します。 (継承元 Timeline)
EasingFunction	このアニメーションに適用されているイージング機能を取得または設定します。
FillBehavior	アクティブ期間の終わりに達した後の Timeline の動作を指定する値を取得または設定します。 (継承元 Timeline)
From	アニメーションの開始値を取得または設定します。
HasAnimatedProperties	1 つ以上の AnimationClock オブジェクトが、このオブジェクトの任意の依存関係プロパティに関連付けられているかどうかを示す値を取得または設定します。 (継承元 Animatable)
IsAdditive	対象プロパティの現在の値をこのアニメーションの開始値に追加するかどうかを示す値を取得または設定します。
IsCumulative	アニメーションが繰り返されるときに、その値を累計するかどうかを指定する値を取得または設定します。
IsDestinationDefault	このアニメーションが終点の値として GetCurrentValue(Object, Object, AnimationClock) メソッドの defaultDestinationValue パラメーターを使用するかどうかを示す値を取得します。 (継承元 AnimationTimeline)
IsFrozen	オブジェクトが変更可能かどうかを示す値を取得します。 (継承元 Freezable)
IsSealed	このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。 (継承元 DependencyObject)
Name	この Timeline の名前を取得または設定します。 (継承元 Timeline)
RepeatBehavior	このタイムラインの繰り返し動作を取得または設定します。 (継承元 Timeline)
SpeedRatio	この Timeline の時間の進行の速度 (親に対する相対的な速度) を取得または設定します。 (継承元 Timeline)
TargetPropertyType	このアニメーションで生成される値の型を取得します。 (継承元 SingleAnimationBase)
To	アニメーションの終了値を取得または設定します。

メソッド

AllocateClock()	この Clock の AnimationTimeline を作成します。 (継承元 AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock)	AnimationClock を指定した DependencyProperty に適用します。プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	AnimationClock を指定した DependencyProperty に適用します。プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable)
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()	この SingleAnimation の変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。このメソッドは、依存関係プロパティをコピーするときにリソース参照とデータバインディングをコピーしますが (ただし、これらは解決されなくなる場合があります)、アニメーションやその現在の値はコピーしません。
CloneCore(Freezable)	基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを、指定した Freezable の複製 (詳細コピー) にします。 (継承元 Freezable)
CloneCurrentValue()	この Timeline オブジェクトの変更可能な複製を作成し、このオブジェクトの現在値の詳細コピーを作成します。 (継承元 Timeline)
CloneCurrentValueCore(Freezable)	現在のプロパティ値を使用して、インスタンスを、指定した Freezable の変更可能な複製 (詳細コピー) にします。 (継承元 Freezable)
CoerceValue(DependencyProperty)	指定した依存関係プロパティの値を強制します。これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティメタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。 (継承元 DependencyObject)
CreateClock()	この AnimationTimeline から新しい AnimationClock を作成します。 (継承元 AnimationTimeline)
CreateClock(Boolean)	この Clock から新しい Timeline を作成し、その新しい Clock が制御可能かどうかを指定します。この Timeline に子がある場合は、この Timeline をルートにしてクロックのツリーが作成されます。 (継承元 Timeline)
CreateInstance()	Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable)
CreateInstanceCore()	PointAnimationUsingKeyFrames の新しいインスタンスを作成します。
Equals(Object)	指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。 (継承元 DependencyObject)
Freeze()	現在のオブジェクトを変更不可能にし、その IsFrozen プロパティを `true` に設定します。 (継承元 Freezable)
FreezeCore(Boolean)	この Timeline を変更不可能な状態にするか、変更不可能な状態にできるかどうかを判断します。 (継承元 Timeline)
GetAnimationBaseValue(DependencyProperty)	指定した DependencyProperty のアニメーション化されていない値を返します。 (継承元 Animatable)
GetAsFrozen()	基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の固定されたコピーを作成します。コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (継承元 Freezable)
GetAsFrozenCore(Freezable)	このインスタンスを、指定した Timeline オブジェクトの複製にします。 (継承元 Timeline)
GetCurrentValue(Object, Object, AnimationClock)	アニメーションの現在の値を取得します。 (継承元 SingleAnimationBase)
GetCurrentValue(Single, Single, AnimationClock)	アニメーションの現在の値を取得します。 (継承元 SingleAnimationBase)
GetCurrentValueAsFrozen()	現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (継承元 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	このインスタンスを、指定された Timeline の凍結された複製にします。リソース参照、データバインディング、アニメーションはコピーされませんが、それらの現在値はコピーされます。 (継承元 Timeline)
GetCurrentValueCore(Single, Single, AnimationClock)	SingleAnimation によって決定されたように、アニメーション化されているプロパティの現在の値を表す値を計算します。
GetHashCode()	この DependencyObject のハッシュコードを取得します。 (継承元 DependencyObject)
GetLocalValueEnumerator()	どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。 (継承元 DependencyObject)
GetNaturalDuration(Clock)	この Timeline の 1 回の反復の長さを返します。 (継承元 Timeline)
GetNaturalDurationCore(Clock)	この AnimationTimeline の 1 回の反復の長さを返します。 (継承元 AnimationTimeline)
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)
ReadLocalValue(DependencyProperty)	ローカルの依存関係プロパティの値を返します (存在する場合)。 (継承元 DependencyObject)
ReadPreamble()	Freezable が有効なスレッドからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータメンバーを読み取る任意の API の開始時に、このメソッドを呼び出す必要があります。 (継承元 Freezable)
SetCurrentValue(DependencyProperty, Object)	依存関係プロパティ値のソースを変更せずにその値を設定します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)	依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
VerifyAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (継承元 DispatcherObject)
WritePostscript()	Freezable の Changed イベントを発生させ、その OnChanged() メソッドを呼び出します。 Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラスメンバーを変更するすべての API の終了時に、このメソッドを呼び出す必要があります。 (継承元 Freezable)
WritePreamble()	Freezable が固定されておらず、有効なスレッドコンテキストからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータメンバーに書き込む任意の API の開始時に、このメソッドを呼び出す必要があります。 (継承元 Freezable)

イベント

Changed	Freezable、またはこれに含まれているオブジェクトが変更されると発生します。 (継承元 Freezable)
Completed	このタイムラインの再生が完全に終了したときに発生します。このタイムラインは、もうアクティブ期間に入りません。 (継承元 Timeline)
CurrentGlobalSpeedInvalidated	タイムラインのクロックの時間の進行の速度が変化すると発生します。 (継承元 Timeline)
CurrentStateInvalidated	タイムラインの Clock の CurrentState プロパティが更新されたときに発生します。 (継承元 Timeline)
CurrentTimeInvalidated	タイムラインの Clock の CurrentTime プロパティが更新されたときに発生します。 (継承元 Timeline)
RemoveRequested	このタイムラインのために作成されたクロックか、親タイムラインのクロックが削除された場合に発生します。 (継承元 Timeline)

適用対象

次の方法で共有