IUIAnimationManager：：Update 方法 (uianimation.h)

發行項
03/13/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 Vista 的 Windows 7、Windows Vista 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	uianimation.h
Dll	UIAnimation.dll