IUIAnimationStoryboard::AddTransitionBetweenKeyframes method (uianimation.h)

Artikel
08/26/2023

Menambahkan transisi antara dua keyframe.

Sintaks

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe,
  [in] UI_ANIMATION_KEYFRAME  endKeyframe
);

Parameter

[in] variable

Variabel animasi yang transisinya akan ditambahkan.

[in] transition

Transisi yang akan ditambahkan.

[in] startKeyframe

Keyframe yang menentukan awal transisi baru.

[in] endKeyframe

Keyframe yang menentukan akhir transisi baru. EndKeyframe tidak boleh muncul lebih awal di papan cerita daripada startKeyframe.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
UI_E_TRANSITION_ALREADY_USED	Transisi ini telah ditambahkan ke papan cerita atau telah ditambahkan ke papan cerita yang telah selesai diputar dan telah dirilis.
UI_E_TRANSITION_ECLIPSED	Transisi mungkin membuat gerhana awal transisi lain di papan cerita.
UI_E_START_KEYFRAME_AFTER_END	Keyframe awal mungkin terjadi setelah keyframe akhir.

Keterangan

Metode ini menerapkan transisi yang ditentukan ke variabel yang ditentukan di papan cerita, dengan transisi dimulai dan berakhir pada keyframe yang ditentukan. Jika transisi dibuat dengan parameter durasi yang ditentukan, durasi tersebut ditimpa dengan durasi waktu antara keyframe awal dan akhir. Jika tidak, Animasi Windows mempercepat atau memperlambat transisi seperlunya.

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

Transisi harus ditambahkan dalam urutan pemutarannya. Transisi dapat mulai diputar sebelum transisi sebelumnya di papan cerita telah selesai, dalam hal ini nilai awal dan kecepatan yang terlihat oleh transisi baru akan ditentukan oleh status yang sebelumnya. Transisi tidak boleh dimulai sebelum dimulainya transisi sebelumnya.

Persyaratan


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