Storyboard.GetCurrentState メソッド

定義

名前空間:

Windows.UI.Xaml.Media.Animation

ストーリーボードのクロック状態を取得します。

public:
 virtual ClockState GetCurrentState() = GetCurrentState;

ClockState GetCurrentState();

public ClockState GetCurrentState();

function getCurrentState()

Public Function GetCurrentState () As ClockState

戻り値

ClockState

列挙値の 1 つ。 [ アクティブ]、[ 塗りつぶし]、または [停止] を指定できます。

注釈

このメソッドは、アニメーションが開始される前に、実行時にアニメーションのプロパティを変更する場合に便利です。 停止されたアニメーション (GetCurrentState は ClockState.Stopped を返します) は引き続き変更できます。 実行中のアニメーション (GetCurrentState は ClockState.Active または ClockState.Filling を返します) は変更できず、試行するとエラーが発生します。

以前のバージョンの注意事項

Windows 8

アニメーションには省略可能な BeginTime 値を指定できます。これは、アニメーションが実際に値に影響を与え始めたときに、制御するストーリーボードが開始されたときと比較して変更されます。 実行中の時間がまだ BeginTime に達していない場合でも、ストーリーボードを開始した後にアニメーションのプロパティを変更することは無効です。 Windows 8の場合、実行中のアニメーションに対して GetCurrentState を呼び出すと、実行中の時刻が BeginTime に達していない場合、常に ClockState.Stopped が返されます。 通常、 停止した アニメーションのプロパティを変更することは有効ですが、この特定の場合は変更されません。そのため、アニメーションを変更することが有効かどうかを判断するために GetCurrentState を使用すると、常に正確であるとは限りません。 Windows 8.1以降、ストーリーボードによって開始されたアニメーションに対して GetCurrentState を呼び出すと、BeginTime 値が存在し、到達していない場合でも、ClockState.Active が常に返されます。 GetCurrentState が ClockState.Filling を返す状況は変わりません。

Windows 8 用にコンパイルしたアプリは、Windows 8.1 上で実行しても Windows 8 のときと同じ動作になります。

こちらもご覧ください

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