SingleAnimation Kelas

Definisi

Ruang nama:

System.Windows.Media.Animation

Rakitan:

PresentationCore.dll

Menganimasikan nilai Single properti antara dua nilai target menggunakan interpolasi linier melalui Duration.

public ref class SingleAnimation : System::Windows::Media::Animation::SingleAnimationBase

public class SingleAnimation : System.Windows.Media.Animation.SingleAnimationBase

type SingleAnimation = class
    inherit SingleAnimationBase

Public Class SingleAnimation
Inherits SingleAnimationBase

Warisan

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

SingleAnimationBase

SingleAnimation

Keterangan

Animasi memperbarui nilai properti selama periode waktu tertentu. Efek animasi bisa halang, seperti memindahkan Shape beberapa piksel ke kiri dan kanan, atau dramatis, seperti memperbesar objek menjadi 200 kali ukuran aslinya saat memutarnya dan mengubah warnanya. Untuk membuat animasi di Windows Presentation Foundation (WPF), Anda mengaitkan animasi dengan nilai properti objek.

Nilai Target

Kelas SingleAnimation membuat transisi antara dua nilai target. Untuk mengatur nilai targetnya, gunakan Fromproperti , To, dan By . Tabel berikut ini meringkas bagaimana Fromproperti , To, dan By dapat digunakan bersama-sama atau secara terpisah untuk menentukan nilai target animasi.

Properti yang ditentukan	Perilaku yang dihasilkan
From	Animasi berkembang dari nilai yang ditentukan oleh From properti ke nilai dasar properti yang dianimasikan atau ke nilai output animasi sebelumnya, tergantung pada bagaimana animasi sebelumnya dikonfigurasi.
From dan To	Animasi maju dari nilai yang ditentukan oleh From properti ke nilai yang ditentukan oleh To properti .
From dan By	Animasi maju dari nilai yang ditentukan oleh From properti ke nilai yang ditentukan oleh jumlah From properti dan By .
To	Animasi berkembang dari nilai dasar properti animasi atau nilai output animasi sebelumnya ke nilai yang ditentukan oleh To properti .
By	Animasi berkembang dari nilai dasar properti yang dianimasikan atau nilai output animasi sebelumnya ke jumlah nilai tersebut dan nilai yang ditentukan oleh By properti .

Catatan

Jika Anda mengatur To properti dan By , To properti diutamakan dan By properti diabaikan.

Untuk menggunakan metode interpolasi lain atau menganimasikan antara lebih dari dua nilai target, gunakan SingleAnimationUsingKeyFrames objek .

Untuk informasi tentang menerapkan beberapa animasi ke satu properti, lihat Gambaran Umum Animasi Key-Frame.

Fitur yang Dapat Di-freezable

SingleAnimation Karena kelas mewarisi dari Freezable, SingleAnimation objek mendapatkan beberapa fitur khusus, yang mencakup hal berikut: mereka dapat dideklarasikan sebagai sumber daya, dibagikan di antara beberapa objek, dibuat baca-saja untuk meningkatkan performa, mengkloning, dan membuat utas aman. Untuk informasi selengkapnya tentang berbagai fitur yang disediakan oleh Freezable objek, lihat Gambaran Umum Freezable Objects.

Konstruktor

SingleAnimation()	Menginisialisasi instans baru kelas SingleAnimation.
SingleAnimation(Single, Duration)	Menginisialisasi instans SingleAnimation baru kelas yang menganimasikan ke nilai yang ditentukan selama durasi yang ditentukan. Nilai awal untuk animasi adalah nilai dasar properti yang dianimasikan atau output dari animasi lain.
SingleAnimation(Single, Duration, FillBehavior)	Menginisialisasi instans SingleAnimation baru kelas yang menganimasikan ke nilai yang ditentukan selama durasi yang ditentukan dan memiliki perilaku pengisian yang ditentukan. Nilai awal untuk animasi adalah nilai dasar properti yang dianimasikan atau output dari animasi lain.
SingleAnimation(Single, Single, Duration)	Menginisialisasi instans SingleAnimation baru kelas yang menganimasikan dari nilai awal yang ditentukan ke nilai tujuan yang ditentukan selama durasi yang ditentukan.
SingleAnimation(Single, Single, Duration, FillBehavior)	Menginisialisasi instans SingleAnimation baru kelas yang menganimasikan dari nilai awal yang ditentukan ke nilai tujuan yang ditentukan selama durasi yang ditentukan dan memiliki perilaku pengisian yang ditentukan.

Bidang

ByProperty	By Mengidentifikasi properti dependensi.
EasingFunctionProperty	EasingFunction Mengidentifikasi properti dependensi.
FromProperty	From Mengidentifikasi properti dependensi.
ToProperty	To Mengidentifikasi properti dependensi.

Properti

AccelerationRatio	Mendapatkan atau menetapkan nilai yang menentukan persentase garis waktu Duration yang dihabiskan untuk mempercepat berlalunya waktu dari nol hingga tingkat maksimumnya. (Diperoleh dari Timeline)
AutoReverse	Mendapatkan atau menetapkan nilai yang menunjukkan apakah garis waktu diputar secara terbalik setelah menyelesaikan perulangan ke depan. (Diperoleh dari Timeline)
BeginTime	Mendapatkan atau mengatur waktu di mana ini Timeline harus dimulai. (Diperoleh dari Timeline)
By	Mendapatkan atau mengatur jumlah total di mana animasi mengubah nilai awalnya.
CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
DecelerationRatio	Mendapatkan atau menetapkan nilai yang menentukan persentase dari garis Duration waktu yang dihabiskan untuk mengurangi berlalunya waktu dari tingkat maksimumnya menjadi nol. (Diperoleh dari Timeline)
DependencyObjectType	Mendapatkan yang membungkus jenis CLR instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
Duration	Mendapatkan atau mengatur lamanya waktu pemutaran garis waktu ini, bukan menghitung pengulangan. (Diperoleh dari Timeline)
EasingFunction	Mendapatkan atau menyetel fungsi permudah yang diterapkan ke animasi ini.
FillBehavior	Mendapatkan atau menetapkan nilai yang menentukan bagaimana Timeline perilaku setelah mencapai akhir periode aktifnya. (Diperoleh dari Timeline)
From	Mendapatkan atau mengatur nilai awal animasi.
HasAnimatedProperties	Mendapatkan nilai yang menunjukkan apakah satu atau beberapa AnimationClock objek dikaitkan dengan salah satu properti dependensi objek ini. (Diperoleh dari Animatable)
IsAdditive	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai properti target saat ini harus ditambahkan ke nilai awal animasi ini.
IsCumulative	Mendapatkan atau mengatur nilai yang menentukan apakah nilai animasi terakumulasi saat berulang.
IsDestinationDefault	Mendapatkan nilai yang menunjukkan apakah animasi ini menggunakan parameter defaultDestinationValue dari GetCurrentValue(Object, Object, AnimationClock) metode sebagai nilai tujuannya. (Diperoleh dari AnimationTimeline)
IsFrozen	Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi. (Diperoleh dari Freezable)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
Name	Mendapatkan atau menetapkan nama ini Timeline. (Diperoleh dari Timeline)
RepeatBehavior	Mendapatkan atau mengatur perilaku berulang dari garis waktu ini. (Diperoleh dari Timeline)
SpeedRatio	Mendapatkan atau menetapkan tarif, relatif terhadap induknya, pada saat itu berkembang untuk ini Timeline. (Diperoleh dari Timeline)
TargetPropertyType	Mendapatkan tipe nilai yang dihasilkan animasi ini. (Diperoleh dari SingleAnimationBase)
To	Mendapatkan atau mengatur nilai akhir animasi.

Metode

AllocateClock()	Clock Membuat untuk iniAnimationTimeline. (Diperoleh dari AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock)	AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
Clone()	Membuat kloning yang dapat dimodifikasi dari ini SingleAnimation, membuat salinan mendalam dari nilai objek ini. Saat menyalin properti dependensi, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini.
CloneCore(Freezable)	Menjadikan instans sebagai kloning (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
CloneCurrentValue()	Membuat klon objek ini Timeline yang dapat dimodifikasi, membuat salinan mendalam dari nilai objek ini saat ini. (Diperoleh dari Timeline)
CloneCurrentValueCore(Freezable)	Menjadikan instans sebagai kloning yang dapat dimodifikasi (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti saat ini. (Diperoleh dari Freezable)
CoerceValue(DependencyProperty)	Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CreateClock()	Membuat baru AnimationClock dari ini AnimationTimeline. (Diperoleh dari AnimationTimeline)
CreateClock(Boolean)	Membuat baru Clock dari ini Timeline dan menentukan apakah yang baru Clock dapat dikontrol. Jika ini Timeline memiliki anak-anak, pohon jam dibuat dengan ini Timeline sebagai akar. (Diperoleh dari Timeline)
CreateInstance()	Menginisialisasi instans baru kelas Freezable. (Diperoleh dari Freezable)
CreateInstanceCore()	Membuat instans baru dari PointAnimationUsingKeyFrames.
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
Freeze()	Membuat objek saat ini tidak dapat dimodifikasi dan mengatur propertinya IsFrozen ke true. (Diperoleh dari Freezable)
FreezeCore(Boolean)	Membuat ini Timeline tidak dapat dimodifikasi atau menentukan apakah dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Timeline)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai non-animasi dari yang ditentukan DependencyProperty. (Diperoleh dari Animatable)
GetAsFrozen()	Membuat salinan beku dari Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek yang dibekukan disalin oleh referensi. (Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)	Menjadikan instans ini sebagai klon objek yang ditentukan Timeline . (Diperoleh dari Timeline)
GetCurrentValue(Object, Object, AnimationClock)	Mendapatkan nilai animasi saat ini. (Diperoleh dari SingleAnimationBase)
GetCurrentValue(Single, Single, AnimationClock)	Mendapatkan nilai animasi saat ini. (Diperoleh dari SingleAnimationBase)
GetCurrentValueAsFrozen()	Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek yang dibekukan disalin oleh referensi. (Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Menjadikan instans ini sebagai klon beku dari yang ditentukan Timeline. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini. (Diperoleh dari Timeline)
GetCurrentValueCore(Single, Single, AnimationClock)	Menghitung nilai yang mewakili nilai properti saat ini yang dianimasikan, seperti yang ditentukan oleh SingleAnimation.
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetNaturalDuration(Clock)	Mengembalikan panjang perulangan tunggal dari ini Timeline. (Diperoleh dari Timeline)
GetNaturalDurationCore(Clock)	Mengembalikan panjang perulangan tunggal dari ini AnimationTimeline. (Diperoleh dari AnimationTimeline)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi ulang nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnChanged()	Dipanggil ketika objek saat ini Freezable dimodifikasi. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk DependencyObjectType anggota data yang baru saja ditetapkan. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Mengambil alih DependencyObject implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs) untuk juga memanggil handler apa pun Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable. (Diperoleh dari Freezable)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
ReadPreamble()	Memastikan bahwa Freezable sedang diakses dari utas yang valid. Pewaris Freezable harus memanggil metode ini di awal API apa pun yang membaca anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
WritePostscript()	Menaikkan Changed peristiwa untuk Freezable dan memanggil metodenya OnChanged() . Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi. (Diperoleh dari Freezable)
WritePreamble()	Memverifikasi bahwa Freezable tidak dibekukan dan diakses dari konteks utas yang valid. Freezable pewaris harus memanggil metode ini di awal API apa pun yang menulis ke anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)

Acara

Changed	Terjadi ketika Freezable atau objek yang dikandungnya dimodifikasi. (Diperoleh dari Freezable)
Completed	Terjadi ketika garis waktu ini telah benar-benar selesai diputar: itu tidak akan lagi memasuki periode aktifnya. (Diperoleh dari Timeline)
CurrentGlobalSpeedInvalidated	Terjadi ketika laju saat berlangsung untuk jam garis waktu berubah. (Diperoleh dari Timeline)
CurrentStateInvalidated	Terjadi ketika CurrentState properti garis Clock waktu diperbarui. (Diperoleh dari Timeline)
CurrentTimeInvalidated	Terjadi ketika CurrentTime properti garis Clock waktu diperbarui. (Diperoleh dari Timeline)
RemoveRequested	Terjadi ketika jam yang dibuat untuk garis waktu ini atau salah satu garis waktu induknya dihapus. (Diperoleh dari Timeline)

Lihat juga

• SingleAnimationUsingKeyFrames
• Freezable