FreezableCollection<T> Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Mewakili kumpulan DependencyObjectobjek , Freezable, atau Animatable . FreezableCollection<T> adalah jenisnya Animatable sendiri.

generic <typename T>
 where T : DependencyObjectpublic ref class FreezableCollection : System::Windows::Media::Animation::Animatable, System::Collections::Generic::ICollection<T>, System::Collections::Generic::IEnumerable<T>, System::Collections::Generic::IList<T>, System::Collections::IList, System::Collections::Specialized::INotifyCollectionChanged, System::ComponentModel::INotifyPropertyChanged

public class FreezableCollection<T> : System.Windows.Media.Animation.Animatable, System.Collections.Generic.ICollection<T>, System.Collections.Generic.IEnumerable<T>, System.Collections.Generic.IList<T>, System.Collections.IList, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.INotifyPropertyChanged where T : DependencyObject

type FreezableCollection<'T (requires 'T :> DependencyObject)> = class
    inherit Animatable
    interface ICollection<'T (requires 'T :> DependencyObject)>
    interface seq<'T (requires 'T :> DependencyObject)>
    interface IEnumerable
    interface IList<'T (requires 'T :> DependencyObject)>
    interface ICollection
    interface IList
    interface INotifyCollectionChanged
    interface INotifyPropertyChanged

Public Class FreezableCollection(Of T)
Inherits Animatable
Implements ICollection(Of T), IEnumerable(Of T), IList, IList(Of T), INotifyCollectionChanged, INotifyPropertyChanged

Jenis parameter

T

Jenis koleksi. Jenis ini harus merupakan DependencyObject kelas turunan atau .

Warisan

Object

DispatcherObject

DependencyObject

Freezable

Animatable

FreezableCollection<T>

Turunan

System.Windows.Controls.Ribbon.RibbonControlSizeDefinitionCollection

System.Windows.Controls.Ribbon.RibbonGroupSizeDefinitionBaseCollection

System.Windows.Shell.ThumbButtonInfoCollection

Penerapan

ICollection<T> IEnumerable<T> IList<T> ICollection IEnumerable IList INotifyCollectionChanged INotifyPropertyChanged

Keterangan

Kelas ini disediakan untuk mengaktifkan pembuatan jenis koleksi kustom yang sepenuhnya mendukung pengikatan data, pemberitahuan perubahan, pembatalan properti, dan animasi kontennya.

Penggunaan XAML untuk FreezableCollection

FreezableCollection<T> mendukung sintaks XAML terbatas.

• Sebagai elemen objek di akar, Anda dapat secara teoritis menentukan elemen objek yang tidak dibatasi FreezableCollection<T> , yang juga harus menentukan x:TypeArguments Directive untuk menyatakan batasan. Namun, ini bukan skenario umum, karena untuk melakukan ini, FreezableCollection<T> harus menjadi elemen akar. Batasan ini ada karena implementasi prosesor XAML di WPF hanya dapat mendukung x:TypeArguments Directive ketika elemen yang diaturnya adalah elemen root, dan Anda harus menggunakan pada generik batasan terbuka jika Anda ingin membuat instans jenis generik di XAML. Tidak mungkin Anda menginginkan FreezableCollection<T> sebagai elemen akar, bahkan sebagai XAML yang longgar.

• Jika Anda berasal dari FreezableCollection<T> dan menerapkan batasan jenis dalam koleksi turunan, koleksi turunan dapat mendukung berbagai penggunaan. Ini dimungkinkan karena batasan dalam turunan Anda menghilangkan kebutuhan untuk lulus .

  • Penggunaan XAML yang khas untuk koleksi turunan tersebut adalah melalui sintaks pengumpulan implisit. Koleksi yang mendukung antarmuka tertentu tidak perlu menentukan koleksi itu sendiri sebagai elemen objek. Untuk detail tentang sintaks pengumpulan di XAML, lihat Sintaks XAML Secara Mendetail. Misalnya, objek dengan properti di mana properti berjenis FreezableCollection<T> dibatasi oleh DependencyObject dapat mendukung sintaks berikut:

    <object>  
      <object.property>  
        oneOrMoreDependencyObjectElements  
      </object.property>  
    </object>  
    

  • Selama Anda tidak menyembunyikan konstruktor tanpa parameter, koleksi turunan juga dapat mendukung sintaks elemen objek (di mana elemen objek eksplisit, dibandingkan dengan penggunaan implisit yang ditunjukkan di atas). Ini tidak perlu menjadi elemen akar. Atau, Anda juga dapat menggunakan koleksi turunan sebagai elemen akar, tanpa perlu menentukan , meskipun menggunakan koleksi sebagai elemen akar jarang.

• Setiap elemen anak dari koleksi dalam salah satu skenario di atas harus memiliki jenis batasan yang diimplementasikan, atau sebagaimana ditentukan oleh .

Konstruktor

FreezableCollection<T>()	Menginisialisasi instans FreezableCollection<T> baru yang kosong dan memiliki kapasitas awal default.
FreezableCollection<T>(IEnumerable<T>)	Menginisialisasi instans FreezableCollection<T> baru kelas yang berisi elemen yang sama dengan koleksi yang ditentukan.
FreezableCollection<T>(Int32)	Menginisialisasi instans FreezableCollection<T> baru yang kosong dan memiliki kapasitas awal yang ditentukan.

Properti

CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
Count	Mendapatkan jumlah elemen yang terkandung oleh ini FreezableCollection<T>.
DependencyObjectType	Mendapatkan yang membungkus jenis CLR instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
HasAnimatedProperties	Mendapatkan nilai yang menunjukkan apakah satu atau beberapa AnimationClock objek dikaitkan dengan salah satu properti dependensi objek ini. (Diperoleh dari Animatable)
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)
Item[Int32]	Mendapatkan atau mengatur elemen pada indeks yang ditentukan.

Metode

Add(T)	Menambahkan objek yang ditentukan ke akhir FreezableCollection<T>.
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)
Clear()	Menghapus semua elemen dari koleksi.
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 FreezableCollection<T> dan kontennya, membuat salinan mendalam. Jika koleksi ini (atau kontennya) memiliki properti dependensi animasi, nilai dasar properti disalin, bukan nilai animasinya saat ini.
CloneCore(Freezable)	Jadikan instans ini sebagai kloning (salinan mendalam) dari yang ditentukan FreezableCollection<T> menggunakan nilai properti dasar (non-animasi).
CloneCurrentValue()	Membuat salinan yang dapat dimodifikasi dari ini FreezableCollection<T> dan isinya, membuat salinan mendalam dari nilai objek ini saat ini. Jika objek ini (atau objek yang dikandungnya) berisi properti dependensi animasi, nilai animasinya saat ini akan disalin.
CloneCurrentValueCore(Freezable)	Menjadikan instans ini kloning yang dapat dimodifikasi (salinan mendalam) dari yang ditentukan FreezableCollection<T> menggunakan nilai properti saat ini.
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)
Contains(T)	Menentukan apakah ini FreezableCollection<T> berisi nilai yang ditentukan.
CopyTo(T[], Int32)	Menyalin seluruh FreezableCollection<T> ke array satu dimensi yang kompatibel, dimulai dari indeks array target yang ditentukan.
CreateInstance()	Menginisialisasi instans baru kelas Freezable. (Diperoleh dari Freezable)
CreateInstanceCore()	Membuat instans baru dari FreezableCollection<T>.
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 objek ini FreezableCollection<T> tidak dapat dimodifikasi atau menentukan apakah objek dapat dibuat tidak dapat dimodifikasi.
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 kloning beku dari yang ditentukan FreezableCollection<T> menggunakan nilai properti dasar (non-animasi).
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 kloning beku dari yang ditentukan Freezable. Jika objek ini memiliki properti dependensi animasi, nilai animasinya saat ini akan disalin.
GetEnumerator()	Mengembalikan enumerator untuk seluruh FreezableCollection<T>.
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)
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)
IndexOf(T)	Mencari objek yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh FreezableCollection<T>.
Insert(Int32, T)	Menyisipkan objek yang ditentukan ke dalam pada FreezableCollection<T> indeks yang ditentukan.
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)
Remove(T)	Menghapus kemunculan pertama objek yang ditentukan dari FreezableCollection<T>.
RemoveAt(Int32)	Menghapus objek pada indeks berbasis nol yang ditentukan dari FreezableCollection<T>.
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)

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Untuk deskripsi anggota ini, lihat CopyTo(Array, Int32).
ICollection.IsSynchronized	Untuk deskripsi anggota ini, lihat IsSynchronized.
ICollection.SyncRoot	Untuk deskripsi anggota ini, lihat SyncRoot.
ICollection<T>.IsReadOnly	Untuk deskripsi anggota ini, lihat IsReadOnly.
IEnumerable.GetEnumerator()	Untuk deskripsi anggota ini, lihat GetEnumerator().
IEnumerable<T>.GetEnumerator()	Untuk deskripsi anggota ini, lihat GetEnumerator().
IList.Add(Object)	Untuk deskripsi anggota ini, lihat Add(Object).
IList.Contains(Object)	Untuk deskripsi anggota ini, lihat Contains(Object).
IList.IndexOf(Object)	Untuk deskripsi anggota ini, lihat IndexOf(Object).
IList.Insert(Int32, Object)	Untuk deskripsi anggota ini, lihat Insert(Int32, Object).
IList.IsFixedSize	Untuk deskripsi anggota ini, lihat IsFixedSize.
IList.IsReadOnly	Untuk deskripsi anggota ini, lihat IsReadOnly.
IList.Item[Int32]	Untuk deskripsi anggota ini, lihat Item[Int32].
IList.Remove(Object)	Untuk deskripsi anggota ini, lihat Remove(Object).
INotifyCollectionChanged.CollectionChanged	Untuk deskripsi anggota ini, lihat CollectionChanged.
INotifyPropertyChanged.PropertyChanged	Untuk deskripsi anggota ini, lihat PropertyChanged.

Metode Ekstensi