IUIAnimationManager::Perbarui metode (uianimation.h)

Artikel
03/13/2024

Updates nilai semua variabel animasi.

Sintaks

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

Parameter

[in] timeNow

Waktu sistem saat ini. Parameter ini harus lebih besar dari atau sama dengan 0,0.

[out, optional] updateResult

Hasil pembaruan. Parameter ini dapat dihilangkan dari panggilan ke metode ini.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan Animasi Windows untuk daftar kode kesalahan.

Keterangan

Memanggil metode ini memajukan manajer animasi ke timeNow, mengubah status papan cerita seperlunya dan memperbarui variabel animasi apa pun ke nilai terinterpolasi yang sesuai. Jika manajer animasi dijeda, tidak ada papan cerita atau variabel yang diperbarui. Jika mode animasi UI_ANIMATION_MODE_DISABLED, semua papan cerita terjadwal segera selesai diputar. Jika nilai variabel apa pun berubah selama panggilan ini, nilai updateResultUI_ANIMATION_UPDATE_VARIABLES_CHANGED; jika tidak, itu UI_ANIMATION_UPDATE_NO_CHANGE.

Contoh

Contoh berikut memperbarui manajer animasi dengan waktu saat ini. Untuk contoh tambahan, lihat Memperbarui Manajer Animasi dan Menggambar Bingkai.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista, dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	uianimation.h
DLL	UIAnimation.dll