Método IUIAnimationManager::Update (uianimation.h)

Artículo
03/03/2024

Novedades los valores de todas las variables de animación.

Sintaxis

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

Parámetros

[in] timeNow

Hora actual del sistema. Este parámetro debe ser mayor o igual que 0,0.

[out, optional] updateResult

Resultado de la actualización. Este parámetro se puede omitir de llamadas a este método.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulta Códigos de error de animación de Windows para obtener una lista de códigos de error.

Comentarios

Al llamar a este método, el administrador de animaciones avanza a timeNow, cambiando los estados de los guiones gráficos según sea necesario y actualizando las variables de animación a los valores interpolados adecuados. Si el administrador de animaciones está en pausa, no se actualizan guiones gráficos ni variables. Si el modo de animación es UI_ANIMATION_MODE_DISABLED, todos los guiones gráficos programados terminan de reproducirse inmediatamente. Si los valores de las variables cambian durante esta llamada, el valor de updateResult es UI_ANIMATION_UPDATE_VARIABLES_CHANGED; de lo contrario, es UI_ANIMATION_UPDATE_NO_CHANGE.

Ejemplos

En el ejemplo siguiente se actualiza el administrador de animaciones con la hora actual. Para obtener ejemplos adicionales, vea Actualizar el Administrador de animaciones y dibujar fotogramas.

// 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)
        {
            ...
        }
    }
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista y Actualización de plataforma para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	uianimation.h
Archivo DLL	UIAnimation.dll