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

Artigo
03/03/2024

Atualizações os valores de todas as variáveis de animação.

Sintaxe

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

Parâmetros

[in] timeNow

A hora atual do sistema. Esse parâmetro deve ser maior ou igual a 0,0.

[out, optional] updateResult

O resultado da atualização. Esse parâmetro pode ser omitido de chamadas para esse método.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de erro de animação do Windows para obter uma lista de códigos de erro.

Comentários

Chamar esse método avança o gerenciador de animação para timeNow, alterando os status dos storyboards conforme necessário e atualizando quaisquer variáveis de animação para valores interpolados apropriados. Se o gerenciador de animação estiver em pausa, nenhum storyboard ou variável será atualizado. Se o modo de animação for UI_ANIMATION_MODE_DISABLED, todos os storyboards agendados terminarão de ser reproduzidos imediatamente. Se os valores de qualquer variável forem alterados durante essa chamada, o valor de updateResultserá UI_ANIMATION_UPDATE_VARIABLES_CHANGED; caso contrário, é UI_ANIMATION_UPDATE_NO_CHANGE.

Exemplos

O exemplo a seguir atualiza o gerenciador de animação com a hora atual. Para obter exemplos adicionais, consulte Atualizar o Gerenciador de Animação e Desenhar Quadros.

// 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	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	uianimation.h
DLL	UIAnimation.dll