ColorAnimationUsingKeyFrames クラス

定義

名前空間:

Windows.UI.Xaml.Media.Animation

一連のキー フレームに沿って Color プロパティの値をアニメーション化します。

public ref class ColorAnimationUsingKeyFrames sealed : Timeline

/// [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.UI.Xaml.Markup.ContentProperty(Name="KeyFrames")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ColorAnimationUsingKeyFrames final : Timeline

[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.UI.Xaml.Markup.ContentProperty(Name="KeyFrames")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ColorAnimationUsingKeyFrames : Timeline

Public NotInheritable Class ColorAnimationUsingKeyFrames
Inherits Timeline

<ColorAnimationUsingKeyFrames ...>
  oneOrMoreColorKeyFrames
</ColorAnimationUsingKeyFrames>

継承

Object Platform::Object IInspectable DependencyObject Timeline ColorAnimationUsingKeyFrames

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows の要件

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

例

次の例では、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

コンストラクター

ColorAnimationUsingKeyFrames()

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

プロパティ

AutoReverse	順方向の反復の完了後に、タイムラインを逆方向に再生するかどうかを示す値を取得または設定します。 (継承元 Timeline)
BeginTime	この タイムライン を開始する時刻を取得または設定します。 (継承元 Timeline)
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
Duration	繰り返しをカウントせずに、このタイムラインの再生に要する時間を取得または設定します。 (継承元 Timeline)
EnableDependentAnimation	依存アニメーションと見なされるアニメーション化されたプロパティに、このアニメーション宣言の使用を許可するかどうかを宣言する値を取得または設定します。
EnableDependentAnimationProperty	EnableDependentAnimation 依存関係プロパティを識別します。
FillBehavior	アニメーションがアクティブ期間の終わりに達した後の動作を指定する値を取得または設定します。 (継承元 Timeline)
KeyFrames	アニメーションを定義する ColorKeyFrame オブジェクトのコレクションを取得します。
RepeatBehavior	このタイムラインの繰り返し動作を取得または設定します。 (継承元 Timeline)
SpeedRatio	このタイムラインの進行状況を示す、親に対する相対的なレートを取得または設定 します。 (継承元 Timeline)

メソッド

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)

イベント

Completed

Storyboard オブジェクトの再生が完了したときに発生します。 (継承元 Timeline)

こちらもご覧ください

• ストーリーボードに設定されたアニメーション