SplineColorKeyFrame クラス

定義

名前空間:

Windows.UI.Xaml.Media.Animation

スプライン補間を使用して、前のキー フレームの Color 値から独自の Value にアニメーション化します。

public ref class SplineColorKeyFrame sealed : ColorKeyFrame

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class SplineColorKeyFrame final : ColorKeyFrame

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SplineColorKeyFrame : ColorKeyFrame

Public NotInheritable Class SplineColorKeyFrame
Inherits ColorKeyFrame

<SplineColorKeyFrame .../>

継承

Object Platform::Object IInspectable DependencyObject ColorKeyFrame SplineColorKeyFrame

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

この XAML の例では、ColorAnimationUsingKeyFrames クラスを使用して、StackPanel の Background プロパティをアニメーション化します。 このアニメーションは、次の方法で 3 つのキー フレームを使用します。

1. 最初の 2 秒の間に、 LinearColorKeyFrame は 徐々に緑から赤に色を変更します。 LinearColorKeyFrame のような線形キー フレームは、値間の滑らかな線形遷移を作成します。
2. 次の 5 分の 1 の終了時に、 DiscreteColorKeyFrame は色を赤から黄色にすばやく変更します。 DiscreteColorKeyFrame のような個別のキー フレームは、値間に突然の変更を作成します。アニメーションはすぐに発生し、値間の補間はまったく行われません。
3. 最後の 2 秒の間に、SplineColorKeyFrame によって色が再び変更されます。今回は黄色から緑に戻ります。 SplineColorKeyFrame のようなスプライン キー フレームは、 KeySpline プロパティの値に従って値間の変数遷移を作成します。 KeySpline は、アニメーション期間中の時間と値の関係を非線形に変更する方法を提供します。特に、リレーションシップは個々のキー フレームで生成するのが困難な曲線になる可能性があります。 この例では、色の変化は最初はゆっくりしていますが、時間セグメントの終点に向かって急激に速くなります。

<StackPanel x:Name="myStackPanel" Background="Red"
Loaded="Start_Animation">
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">

            <ColorAnimationUsingKeyFrames Storyboard.TargetName="myStackPanel" 
      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)">
                
                <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates
                a smooth, linear animation between values. -->
                <LinearColorKeyFrame Value="Blue" KeyTime="00:00:02" />

                <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a 
                sudden jump between values. -->
                <DiscreteColorKeyFrame Value="Yellow" KeyTime="00:00:2.5" />

                <!-- In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame 
                creates a variable transition between values depending on the KeySpline property. In this example,
                the animation starts off slow but toward the end of the time segment, it speeds up exponentially.-->
                <SplineColorKeyFrame Value="Green" KeyTime="00:00:4.5" KeySpline="0.6,0.0 0.9,0.00" />

            </ColorAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
</StackPanel>

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

注釈

キー フレーム アニメーションでは、アニメーション タイムラインに沿ってポイントに到達する複数のターゲット値を使うことができます。 つまり、キー フレームごとに異なる中間値も指定でき、到達した最後のキー フレームが最終的なアニメーション値になります。 複数の値を指定してアニメーション化を行うことで、より複雑なアニメーションを実現できます。 ディスクリート、リニア、スプラインのキーフレームを同じキーフレーム コレクションに混在させることができます。

キー フレーム アニメーションの使用方法の詳細については、「 キー フレーム アニメーションとイージング関数アニメーション」を参照してください。

コンストラクター

SplineColorKeyFrame()

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

プロパティ

Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
KeySpline	このキー フレームのアニメーションの進行を定義する 2 つの制御点を取得または設定します。
KeySplineProperty	KeySpline 依存関係プロパティを識別します。
KeyTime	キー フレームのターゲット 値 に到達する時刻を取得または設定します。 (継承元 ColorKeyFrame)
Value	キー フレームのターゲット値を取得または設定します。 (継承元 ColorKeyFrame)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

こちらもご覧ください

• ColorKeyFrame
• ColorAnimationUsingKeyFrames
• ColorKeyFrameCollection
• KeyTime
• Value
• ストーリーボードに設定されたアニメーション
• キー フレーム アニメーションとイージング関数のアニメーション