Storyboard.GetCurrentState メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public:
virtual ClockState GetCurrentState() = GetCurrentState;ClockState GetCurrentState();public ClockState GetCurrentState();function getCurrentState()Public Function GetCurrentState () As 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 のときと同じ動作になります。