SplineDoubleKeyFrame クラス

定義

名前空間:

Microsoft.UI.Xaml.Media.Animation

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

public ref class SplineDoubleKeyFrame sealed : DoubleKeyFrame

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SplineDoubleKeyFrame final : DoubleKeyFrame

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SplineDoubleKeyFrame : DoubleKeyFrame

Public NotInheritable Class SplineDoubleKeyFrame
Inherits DoubleKeyFrame

<SplineDoubleKeyFrame .../>

継承

Object Platform::Object IInspectable DependencyObject DoubleKeyFrame SplineDoubleKeyFrame

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

例

次の XAML の例では、四角形を画面全体に移動します。 この例では、DoubleAnimationUsingKeyFrames クラスを使用して、Rectangle に適用される TranslateTransform の X プロパティをアニメーション化します。 このアニメーションは、次の方法で 3 つのキー フレームを使用します。

1. 最初の 3 秒間は、 LinearDoubleKeyFrame クラスのインスタンスを使用して、開始位置から 500 の位置まで安定した速度でパスに沿って四角形を移動します。 LinearDoubleKeyFrame のような線形キー フレームは、値間の滑らかな線形遷移を作成します。
2. 4 番目の秒の終わりに、 DiscreteDoubleKeyFrame クラスのインスタンスを使用して、四角形を次の位置に突然移動します。 DiscreteDoubleKeyFrame などの個別のキー フレームでは、値間の急激なジャンプが作成されます。 この例では、開始位置にあった四角形が突然 500 の位置に出現します。
3. 最後の 2 秒では、SplineDoubleKeyFrame クラスのインスタンスを使用して、四角形を開始位置に戻します。 SplineDoubleKeyFrame などのスプライン キー フレームは、 KeySpline プロパティの値に従って値間の変数遷移を作成します。 この例では、四角形の動きは最初はゆっくりしていますが、時間セグメントの終点に向かった急激に速くなります。

<StackPanel>
    <StackPanel.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the TranslateTransform's X property
             from 0 to 350, then 50,
             then 200 over 10 seconds. -->
            <DoubleAnimationUsingKeyFrames
          Storyboard.TargetName="MyAnimatedTranslateTransform"
          Storyboard.TargetProperty="X"
          Duration="0:0:10" EnableDependentAnimation="True">

                <!-- Using a LinearDoubleKeyFrame, the rectangle moves 
                 steadily from its starting position to 500 over 
                 the first 3 seconds.  -->
                <LinearDoubleKeyFrame Value="500" KeyTime="0:0:3" />

                <!-- Using a DiscreteDoubleKeyFrame, the rectangle suddenly 
                 appears at 400 after the fourth second of the animation. -->
                <DiscreteDoubleKeyFrame Value="400" KeyTime="0:0:4" />

                <!-- Using a SplineDoubleKeyFrame, the rectangle moves 
                 back to its starting point. The
                 animation starts out slowly at first and then speeds up. 
                 This KeyFrame ends after the 6th
                 second. -->
                <SplineDoubleKeyFrame KeySpline="0.6,0.0 0.9,0.00" Value="0" KeyTime="0:0:6" />

            </DoubleAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
    <Rectangle Fill="Blue" Width="50" Height="50" Loaded="Start_Animation">
        <Rectangle.RenderTransform>
            <TranslateTransform x:Name="MyAnimatedTranslateTransform" 
             X="0" Y="0" />
        </Rectangle.RenderTransform>
    </Rectangle>
</StackPanel>

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

注釈

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

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

コンストラクター

SplineDoubleKeyFrame()

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

プロパティ

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

メソッド

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)

こちらもご覧ください

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