Animatable.ApplyAnimationClock Metode

Definisi

Ruang nama:

System.Windows.Media.Animation

Rakitan:

PresentationCore.dll

Menganimasikan yang ditentukan DependencyProperty menggunakan yang ditentukan AnimationClock.

Overload

ApplyAnimationClock(DependencyProperty, AnimationClock)	AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, yang ditentukan HandoffBehavior akan digunakan.

ApplyAnimationClock(DependencyProperty, AnimationClock)

AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock);

public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);

abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit

Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock)

Parameter

dp

DependencyProperty

Properti untuk dianimasikan.

clock

AnimationClock

Jam untuk menganimasikan properti yang ditentukan. Jika clock adalah null, semua animasi akan dihapus dari properti yang ditentukan (tetapi tidak dihentikan).

Penerapan

ApplyAnimationClock(DependencyProperty, AnimationClock)

Keterangan

Perhatikan bahwa menggunakan metode ini untuk menghapus jam dari properti tidak menghentikan jam tersebut.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, yang ditentukan HandoffBehavior akan digunakan.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);

public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit

Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock, handoffBehavior As HandoffBehavior)

Parameter

dp

DependencyProperty

Properti untuk dianimasikan.

clock

AnimationClock

Jam untuk menganimasikan properti yang ditentukan. Jika handoffBehavior adalah SnapshotAndReplace dan clock , nullsemua animasi akan dihapus dari properti yang ditentukan (tetapi tidak dihentikan). Jika handoffBehavior adalah Compose dan jam adalah null, metode ini tidak berpengaruh.

handoffBehavior

HandoffBehavior

Nilai yang menentukan bagaimana animasi baru harus berinteraksi dengan animasi saat ini yang sudah mempengaruhi nilai properti.

Penerapan

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Contoh

Contoh berikut menunjukkan cara menerapkan jam animasi menggunakan pengaturan yang berbeda HandoffBehavior .

Keterangan

Perhatikan bahwa menggunakan metode ini untuk menghapus jam dari properti tidak menghentikan jam tersebut.

Menggunakan Compose HandoffBehavior

Ketika Anda menerapkan Storyboard, , atau AnimationClock ke properti menggunakanHandoffBehaviorCompose , objek apa pun Clock yang sebelumnya terkait dengan properti tersebut terus menggunakan sumber daya sistem; sistem pengaturan waktu tidak akan menghapus jam AnimationTimelineini secara otomatis.

Untuk menghindari masalah performa saat Anda menerapkan sejumlah besar jam menggunakan Compose, Anda harus menghapus jam pembuatan dari properti animasi setelah selesai. Ada beberapa cara untuk menghapus jam.

• Untuk menghapus semua jam dari properti, gunakan ApplyAnimationClock(DependencyProperty, AnimationClock) metode atau BeginAnimation(DependencyProperty, AnimationTimeline) objek animasi. Tentukan properti yang dianimasikan sebagai parameter pertama, dan null sebagai yang kedua. Ini akan menghapus semua jam animasi dari properti .

• Untuk menghapus tertentu AnimationClock dari daftar jam, gunakan Controller properti dari AnimationClock untuk mengambil ClockController, lalu panggil Remove metode dari ClockController. Ini biasanya dilakukan di Completed penanganan aktivitas selama satu jam. Perhatikan bahwa hanya jam akar yang dapat dikontrol oleh ClockController; Controller properti jam anak akan mengembalikan null. Perhatikan juga bahwa Completed peristiwa tidak akan dipanggil jika durasi jam yang efektif selamanya. Dalam hal ini, pengguna harus menentukan kapan harus memanggil Remove.

Ini terutama merupakan masalah untuk animasi pada objek yang memiliki masa pakai yang lama. Ketika objek dikumpulkan sampah, jamnya juga akan terputus dan sampah dikumpulkan.

Untuk informasi selengkapnya tentang objek jam, lihat Gambaran Umum Animasi dan Sistem Pengaturan Waktu.