IUIAnimationStoryboard2::Metode jadwal (uianimation.h)

Artikel
08/26/2023

Mengarahkan papan cerita untuk menjadwalkan dirinya sendiri untuk bermain.

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. Anda dapat menghilangkan parameter ini dari panggilan ke metode ini.

Nilai kembali

Mengembalikan S_OK jika berhasil; jika tidak, kode kesalahan HRESULT . Lihat Kode Kesalahan Animasi Windows untuk daftar kode kesalahan.

Keterangan

Metode ini mengarahkan papan cerita untuk mencoba menambahkan dirinya ke jadwal bermain papan cerita, menggunakan aturan ini:

Jika tidak ada papan cerita bermain yang menganimasikan salah satu 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_SCHEDULING_INSUFFICIENT_PRIORITY.

Dimungkinkan untuk 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.

Persyaratan


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