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

Article
03/03/2024

Mises à jour les valeurs de toutes les variables d’animation.

Syntaxe

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

Paramètres

[in] timeNow

Heure système actuelle. Ce paramètre doit être supérieur ou égal à 0,0.

[out, optional] updateResult

Résultat de la mise à jour. Ce paramètre peut être omis des appels à cette méthode.

Valeur retournée

Si la méthode réussit, retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur d’animation Windows .

Remarques

L’appel de cette méthode fait passer le gestionnaire d’animations à timeNow, en modifiant les états des storyboards si nécessaire et en mettant à jour toutes les variables d’animation en valeurs interpolées appropriées. Si le gestionnaire d’animations est suspendu, aucun storyboard ni aucune variable n’est mis à jour. Si le mode animation est UI_ANIMATION_MODE_DISABLED, tous les storyboards planifiés se terminent immédiatement. Si les valeurs d’une variable changent pendant cet appel, la valeur de updateResult est UI_ANIMATION_UPDATE_VARIABLES_CHANGED ; sinon, c’est UI_ANIMATION_UPDATE_NO_CHANGE.

Exemples

L’exemple suivant met à jour le gestionnaire d’animations avec l’heure actuelle. Pour obtenir d’autres exemples, consultez Mettre à jour le Gestionnaire d’animation et les images de dessin.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	uianimation.h
DLL	UIAnimation.dll