Метод 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
Header	uianimation.h
DLL	UIAnimation.dll