IUIAnimationManager::Update-Methode (uianimation.h)

Artikel
03/03/2024

Updates die Werte aller Animationsvariablen.

Syntax

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

Parameter

[in] timeNow

Die aktuelle Systemzeit. Dieser Parameter muss größer oder gleich 0,0 sein.

[out, optional] updateResult

Das Ergebnis der Aktualisierung. Dieser Parameter kann von Aufrufen dieser Methode weggelassen werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter Fehlercodes für die Windows-Animation .

Hinweise

Durch Aufrufen dieser Methode wird der Animations-Manager auf timeNow umsteigen, wobei der Status von Storyboards bei Bedarf geändert und alle Animationsvariablen auf die entsprechenden interpolierten Werte aktualisiert werden. Wenn der Animations-Manager angehalten wird, werden keine Storyboards oder Variablen aktualisiert. Wenn der Animationsmodus UI_ANIMATION_MODE_DISABLED ist, werden alle geplanten Storyboards sofort abgespielt. Wenn sich die Werte von Variablen während dieses Aufrufs ändern, ist der Wert von updateResultUI_ANIMATION_UPDATE_VARIABLES_CHANGED; andernfalls ist sie UI_ANIMATION_UPDATE_NO_CHANGE.

Beispiele

Im folgenden Beispiel wird der Animations-Manager mit der aktuellen Zeit aktualisiert. Weitere Beispiele finden Sie unter Aktualisieren des Animations-Managers und Zeichnen von Frames.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista und Platform Update für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	uianimation.h
DLL	UIAnimation.dll