IUIAnimationStoryboard::Metode jadwal (uianimation.h)
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.
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 |
Lihat juga
IUIAnimationStoryboard::Abandon
IUIAnimationStoryboard::Conclude
IUIAnimationStoryboard::Finish
IUIAnimationStoryboard::GetStatus
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk