IUIAnimationManager：：Update 方法 (uianimation.h)

项目
03/03/2024

汇报所有动画变量的值。

语法

HRESULT Update(
  [in]            UI_ANIMATION_SECONDS       timeNow,
  [out, optional] UI_ANIMATION_UPDATE_RESULT *updateResult
);

参数

[in] timeNow

当前系统时间。此参数必须大于或等于 0.0。

[out, optional] updateResult

更新的结果。对此方法的调用中可以省略此参数。

返回值

如果该方法成功，则它会返回 S_OK。否则，将返回 HRESULT 错误代码。有关错误代码列表，请参阅 Windows 动画错误代码。

注解

调用此方法会将动画管理器提前到 timeNow，根据需要更改情节提要的状态，并将任何动画变量更新为适当的内插值。如果动画管理器已暂停，则不会更新情节提要或变量。如果动画模式 为UI_ANIMATION_MODE_DISABLED，则所有计划的情节提要将立即完成播放。如果在此调用期间任何变量的值发生更改，则 updateResult 的值 UI_ANIMATION_UPDATE_VARIABLES_CHANGED;否则，它将 UI_ANIMATION_UPDATE_NO_CHANGE。

示例

以下示例使用当前时间更新动画管理器。有关其他示例，请参阅更新动画管理器和绘制帧。

// Update the animation manager with the current time
UI_ANIMATION_SECONDS secondsNow;
hr = m_pAnimationTimer->GetTime(
    &secondsNow
    );
if (SUCCEEDED(hr))
{
    UI_ANIMATION_UPDATE_RESULT updateResult;
    hr = m_pAnimationManager->Update(
        secondsNow,
        &updateResult
        );
    if (SUCCEEDED(hr))
    {
        if (updateResult == UI_ANIMATION_UPDATE_VARIABLES_CHANGED)
        {
            ...
        }
    }
}

要求

要求	值
最低受支持的客户端	Windows 7、Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	uianimation.h
DLL	UIAnimation.dll