Metode IUIAnimationInterpolator::GetDependencies (uianimation.h)

Artikel
03/03/2024

Mendapatkan aspek interpolator yang bergantung pada nilai awal atau kecepatan yang diteruskan ke SetInitialValueAndVelocity, atau yang bergantung pada durasi yang diteruskan ke SetDuration.

Sintaks

HRESULT GetDependencies(
  [out] UI_ANIMATION_DEPENDENCIES *initialValueDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *initialVelocityDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *durationDependencies
);

Parameter

[out] initialValueDependencies

Aspek interpolator yang bergantung pada nilai awal yang diteruskan ke SetInitialValueAndVelocity.

[out] initialVelocityDependencies

Aspek interpolator yang bergantung pada kecepatan awal yang diteruskan ke SetInitialValueAndVelocity.

[out] durationDependencies

Aspek interpolator yang bergantung pada durasi yang diteruskan ke SetDuration.

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 dipanggil untuk mengidentifikasi aspek interpolator kustom mana yang dipengaruhi oleh input tertentu: nilai, kecepatan, dan durasi. Untuk setiap input ini, interpolator mengembalikan salah satu hal berikut:

Bitwise-OR dari setiap anggota UI_ANIMATION_DEPENDENCIES yang berlaku.
UI_ANIMATION_DEPENDENCY_NONE jika tidak ada yang tergantung pada input.

Misalnya, pertimbangkan interpolator (1) yang menerima nilai akhir sebagai parameter, (2) yang selalu berhenti bertahap pada nilai akhir tersebut, dan (3) yang durasinya ditentukan oleh perbedaan antara nilai akhir dan awal. Interpolator harus mengembalikan UI_ANIMATION_DURATION UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES| untuk initialValueDependencies. Ini tidak boleh mengembalikan UI_ANIMATION_DEPENDENCY_FINAL_VALUE karena ini diatur ketika interpolator dibuat dan tidak dipengaruhi oleh nilai awal. Demikian juga tidak boleh mengembalikan UI_ANIMATION_DEPENDENCY_FINAL_VELOCITY karena kelopak kurva didefinisikan untuk selalu nol ketika mencapai nilai akhir.

Penting bahwa interpolator mengembalikan sekumpulan bendera yang benar. Jika bendera tidak ada untuk output, Animasi Windows mengasumsikan bahwa parameter yang sesuai tidak memengaruhi aspek hasil interpolator. Misalnya, jika interpolator kustom tidak menyertakan UI_ANIMATION_DEPENDENCY_FINAL_VALUE untuk initialVelocityDependencies, Windows Animation dapat memanggil SetInitialValueAndVelocity dengan parameter kecepatan arbitrer, lalu memanggil GetFinalValue untuk menentukan nilai akhir. Implementasi interpolator GetFinalValue harus mengembalikan hasil yang sama tidak peduli parameter kecepatan apa yang telah diteruskan ke SetInitialValueAndVelocity karena interpolator telah mengklaim bahwa nilai akhir transisi tidak bergantung pada kecepatan awal.

Catatan Jika bendera yang dikembalikan selama durationDependencies tidak menyertakan UI_ANIMATION_DEPENDENCY_DURATION, SetDuration tidak akan pernah dipanggil pada interpolator.

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

IUIAnimationInterpolator

UI_ANIMATION_DEPENDENCIES

Bagikan melalui