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。停止) 仍可修改。 运行 (GetCurrentState 的动画返回 ClockState.Active 或 ClockState.Filling) 无法修改，如果尝试，将收到错误。

以前版本的说明

Windows 8

动画可以有一个可选的 BeginTime 值，该值修改动画实际开始影响值的时间，而控制情节提要何时启动。 即使运行时间尚未达到 BeginTime ，在情节提要启动动画后修改动画的属性也是非法的。 对于Windows 8，为运行时间未达到 BeginTime 的正在运行的动画调用 GetCurrentState 始终返回 ClockState.Stopped。 通常，修改 已停止 动画的属性是合法的，但在此特定情况下则不合法，因此使用 GetCurrentState 来确定修改动画是否合法并不总是准确的。 从 Windows 8.1 开始，为其情节提要启动的动画调用 GetCurrentState 始终返回 ClockState.Active，即使 BeginTime 值存在且尚未达到。 GetCurrentState 返回 ClockState.Filling 的情况保持不变。

对于针对 Windows 8 编译的应用，如果它在 Windows 8.1 上运行，将继续使用 Windows 8 行为。

另请参阅

• GetCurrentTime()
• 情节提要动画