IUIAnimationStoryboard::Metode jadwal (uianimation.h)

Artikel
03/13/2024

Mengarahkan papan cerita untuk menjadwalkan dirinya sendiri untuk dimainkan.

Sintaks

HRESULT Schedule(
  [in]            UI_ANIMATION_SECONDS           timeNow,
  [out, optional] UI_ANIMATION_SCHEDULING_RESULT *schedulingResult
);

Parameter

[in] timeNow

Waktu saat ini.

[out, optional] schedulingResult

Hasil dari permintaan penjadwalan. 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

Metode ini mengarahkan papan cerita untuk mencoba menambahkan dirinya ke jadwal bermain papan cerita. Aturannya adalah sebagai berikut:

Jika tidak ada papan cerita yang diputar yang menanimasikan variabel animasi yang sama, upaya berhasil dan papan cerita mulai segera diputar.
Jika papan cerita memiliki prioritas untuk membatalkan, memangkas, menyimpulkan, atau memadatkan papan cerita yang bertentangan, upaya untuk menjadwalkan berhasil dan papan cerita mulai diputar sesegera mungkin.
Jika papan cerita tidak memiliki prioritas, upaya gagal dan parameter schedulingResult diatur ke UI_ANIMATION_SCHEDULING_INSUFFICIENT_PRIORITY.

Jika metode ini dipanggil dari handler untuk peristiwa OnStoryboardStatusChanged , parameter schedulingResult diatur ke UI_ANIMATION_SCHEDULING_DEFERRED. Satu-satunya cara untuk menentukan apakah papan cerita berhasil dijadwalkan adalah dengan mengatur penanganan aktivitas papan cerita dan memeriksa apakah status papan cerita pernah menjadi UI_ANIMATION_STORYBOARD_INSUFFICIENT_PRIORITY.

Dimungkinkan menggunakan kembali papan cerita dengan memanggil Jadwal lagi setelah statusnya mencapai UI_ANIMATION_STORYBOARD_READY. Upaya untuk menjadwalkan papan cerita saat berada dalam status apa pun selain UI_ANIMATION_STORYBOARD_BUILDING atau UI_ANIMATION_STORYBOARD_READY gagal, dan penjadwalanResult diatur ke UI_ANIMATION_SCHEDULING_ALREADY_SCHEDULED.

Contoh

Contoh berikut mendapatkan waktu saat ini dan menjadwalkan papan cerita. Untuk contoh tambahan, lihat Menjadwalkan Storyboard.

// Get the current time and schedule the storyboard
UI_ANIMATION_SECONDS secondsNow;
hr = m_pAnimationTimer->GetTime(
    &secondsNow
    );
if (SUCCEEDED(hr))
{
    UI_ANIMATION_SCHEDULING_RESULT schedulingResult;
    hr = pStoryboard->Schedule(
        secondsNow,
        &schedulingResult
        );
    if (SUCCEEDED(hr))
    {
        if (schedulingResult == UI_ANIMATION_SCHEDULING_SUCCEEDED)
        {
            ...
        }
        else
        {
            ...
        }
    }
}

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