IUIAnimationManager::Update メソッド (uianimation.h)

[アーティクル]
03/13/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
ヘッダー	uianimation.h
[DLL]	UIAnimation.dll