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

其中一個列舉值。 可以是： 作用中、 填滿或 已停止。

備註

如果您想要在執行時間修改動畫的屬性，在開始動畫之前，這個方法會很有用。 (GetCurrentState 停止的動畫會傳回 ClockState.Stopped) 仍然可以修改。 執行 (GetCurrentState 的動畫會傳回 ClockState.Active 或 ClockState.Filling) 無法修改，如果您嘗試的話，您會收到錯誤。

舊版的注意事項

Windows 8

動畫可以有選擇性的 BeginTime 值，當動畫實際開始影響值時，與控制分鏡腳本啟動時相較之下，會加以修改。 即使執行時間尚未到達 BeginTime ，在腳本啟動時修改動畫的屬性並不合法。 針對Windows 8，呼叫 GetCurrentState 以取得執行中動畫，其中執行時間尚未到達BeginTime一律會傳回ClockState.Stopped。 一般而言，修改 已停止 動畫的屬性是合法的，但在此特定案例中則不是，因此使用 GetCurrentState 來判斷修改動畫是否合法不一定正確。 從 Windows 8.1 開始，即使BeginTime值存在且尚未到達，仍會呼叫 Storyboard 所啟動動畫的 GetCurrentState 一律會傳回ClockState.Active。 GetCurrentState 傳回 ClockState.Filling的情況維持不變。

針對 Windows 8 編譯但在 Windows 8.1 上執行的應用程式會繼續使用 Windows 8 的行為。

另請參閱

• GetCurrentTime()
• 腳本動畫