IUIAnimationStoryboard2::Metode RepeatBetweenKeyframes (uianimation.h)

Artikel
03/03/2024

Membuat perulangan di antara dua keyframe.

Sintaks

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME                   startKeyframe,
  [in] UI_ANIMATION_KEYFRAME                   endKeyframe,
  [in] DOUBLE                                  cRepetition,
  [in] UI_ANIMATION_REPEAT_MODE                repeatMode,
  [in] IUIAnimationLoopIterationChangeHandler2 *pIterationChangeHandler,
  [in] UINT_PTR                                id,
  [in] BOOL                                    fRegisterForNextAnimationEvent
);

Parameter

[in] startKeyframe

Keyframe di mana perulangan akan dimulai.

[in] endKeyframe

Keyframe di mana perulangan akan berakhir. endKeyframe tidak boleh terjadi sebelumnya di papan cerita daripada startKeyframe.

[in] cRepetition

Berapa kali perulangan akan diulang; iterasi terakhir dari perulangan dapat berakhir secara pecahan di antara keyframe. Nilai nol menunjukkan bahwa bagian papan cerita yang ditentukan tidak akan diputar. Nilai UI_ANIMATION_REPEAT_INDEFINITELY (-1) menunjukkan bahwa perulangan akan berulang tanpa batas waktu hingga papan cerita dipangkas atau disimpulkan.

[in] repeatMode

Pola untuk iterasi perulangan.

Nilai UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) menentukan bahwa awal perulangan harus bergantian antara keyframe (k1-k2>, k2-k1>, k1-k2>, dan sebagainya).

Nilai UI_ANIMATION_REPEAT_MODE_NORMAL (0) menentukan bahwa awal perulangan harus dimulai dengan keyframe pertama (k1-k2>, k1-k2>, k1-k2>, dan sebagainya).

Catatan Jika repeatMode memiliki nilai UI_ANIMATION_REPEAT_MODE_ALTERNATE (1) dan cRepetition memiliki nilai UI_ANIMATION_REPEAT_INDEFINITELY (-1), perulangan berakhir pada keyframe akhir.

[in] pIterationChangeHandler

Handler untuk setiap peristiwa perulangan perulangan. Nilai default adalah 0.

[in] id

ID perulangan untuk diteruskan ke pIterationChangeHandler. Nilai default adalah 0.

[in] fRegisterForNextAnimationEvent

Jika true, menentukan bahwa pIterationChangeHandler akan dimasukkan ke dalam perkiraan interval waktu hingga peristiwa animasi berikutnya yang dikembalikan oleh metode IUIAnimationManager2::EstimateNextEventTime . Nilai defaultnya adalah 0, atau false.

Nilai kembali

Jika metode ini berhasil, metode ini 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 memainkan interval antara keyframe yang diberikan berulang kali sebelum memutar sisa papan cerita. Jika jumlah pengulangan terbatas ditentukan, perulangan selalu memainkan berapa kali. Jika UI_ANIMATION_REPEAT_INDEFINITELY (-1) ditentukan, perulangan berulang sampai papan cerita disimpulkan, dalam hal ini iterasi perulangan saat ini selesai dan sisa papan cerita diputar. Papan cerita yang berputar tanpa batas waktu juga berakhir jika terpotong.

Perulangan berlapis dan tumpang tindih tidak didukung.

Keyframe mewakili momen dalam waktu dalam papan cerita dan dapat digunakan untuk menentukan waktu mulai atau berakhir transisi. Karena keyframe dapat ditambahkan di akhir transisi, offset mereka dari awal papan cerita mungkin tidak diketahui sampai papan cerita diputar.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

IUIAnimationStoryboard2

IUIAnimationStoryboard2::AddKeyframeAfterTransition

IUIAnimationStoryboard2::AddKeyframeAtOffset

Bagikan melalui