Metode IUIAnimationInterpolator2::GetDependencies (uianimation.h)

Artikel
08/26/2023

Untuk dimensi yang diberikan, GetDependencies mengambil aspek interpolator yang bergantung pada nilai awal atau kecepatan yang diteruskan ke metode IUIAnimationInterpolator2::SetInitialValueAndVelocity atau durasi yang diteruskan ke metode IUIAnimationInterpolator2::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 ini 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 yang:

Menerima nilai akhir sebagai parameter.
Selalu datang ke perhentian bertahap pada nilai akhir tersebut.
Memiliki durasi yang ditentukan oleh perbedaan antara nilai akhir dan nilai awal.

Dalam hal ini interpolator harus mengembalikan UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATION untuk parameter initialValueDependencies . Ini tidak boleh mengembalikan UI_ANIMATION_DEPENDENCY_FINAL_VALUE, karena nilai ini diatur ketika interpolator dibuat dan tidak terpengaruh oleh nilai awal. Demikian juga, interpolator 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 mana 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 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

IUIAnimationInterpolator2

Bagikan melalui