FreezableCollection<T> Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Reprezentuje kolekcję DependencyObjectobiektów , Freezablelub Animatable . FreezableCollection<T> sam jest typem Animatable .

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

Parametry typu

T

Typ kolekcji. Ten typ musi być klasą pochodną DependencyObject lub .

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

Animatable

FreezableCollection<T>

Pochodne

System.Windows.Controls.Ribbon.RibbonControlSizeDefinitionCollection

System.Windows.Controls.Ribbon.RibbonGroupSizeDefinitionBaseCollection

System.Windows.Shell.ThumbButtonInfoCollection

Implementuje

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

Uwagi

Ta klasa umożliwia tworzenie niestandardowych typów kolekcji, które w pełni obsługują powiązanie danych, powiadomienie o zmianie, unieważnienie właściwości i animację jego zawartości.

Użycie kodu XAML dla klasy FreezableCollection

FreezableCollection<T> obsługuje ograniczoną składnię XAML.

• Jako element obiektu w katalogu głównym można teoretycznie określić nieprzyciągnięty FreezableCollection<T> element obiektu, który musi również określić dyrektywę x:TypeArguments , aby zadeklarować ograniczenie. Jednak nie jest to typowy scenariusz, ponieważ w tym FreezableCollection<T> celu element musi być elementem głównym. To ograniczenie istnieje, ponieważ implementacja procesora XAML w WPF może obsługiwać tylko dyrektywę x:TypeArguments , gdy element, na którym jest ustawiony, jest elementem głównym, i należy użyć w dowolnym otwartym ograniczeniu ogólnym, jeśli chcesz utworzyć wystąpienie typu ogólnego w języku XAML. Jest mało prawdopodobne, że chcesz FreezableCollection<T> jako element główny, nawet jako luźny kod XAML.

• Jeśli pochodzisz z FreezableCollection<T> i zastosujesz ograniczenie typu w kolekcji pochodnej, kolekcja pochodna może obsługiwać różne użycia. Jest to możliwe, ponieważ ograniczenie w wyprowadzeniu eliminuje konieczność przekazania .

  • Typowe użycie kodu XAML dla takiej kolekcji pochodnej odbywa się za pomocą niejawnej składni kolekcji. Kolekcje obsługujące niektóre interfejsy nie muszą określać samej kolekcji jako elementu obiektu. Aby uzyskać szczegółowe informacje na temat składni kolekcji w języku XAML, zobacz Składnia XAML szczegółowo. Na przykład obiekt z właściwością, w której właściwość była ograniczona DependencyObject przez typFreezableCollection<T>, może obsługiwać następującą składnię:

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

  • Tak długo, jak nie ukrywasz konstruktora bez parametrów, kolekcja pochodna może również obsługiwać składnię elementu obiektu (gdzie element obiektu jest jawny, w przeciwieństwie do niejawnego użycia pokazanego powyżej). Nie musi być elementem głównym. Możesz też użyć kolekcji pochodnej jako elementu głównego bez konieczności określania elementu , chociaż używanie kolekcji jako elementu głównego jest rzadkie.

• Wszystkie elementy podrzędne kolekcji w jednym z powyższych scenariuszy muszą być typu zaimplementowanego ograniczenia lub określonego przez .

Konstruktory

FreezableCollection<T>()	Inicjuje nowe wystąpienie, FreezableCollection<T> które jest puste i ma domyślną pojemność początkową.
FreezableCollection<T>(IEnumerable<T>)	Inicjuje FreezableCollection<T> nowe wystąpienie klasy zawierającej te same elementy co określona kolekcja.
FreezableCollection<T>(Int32)	Inicjuje nowe wystąpienie, FreezableCollection<T> które jest puste i ma określoną pojemność początkową.

Właściwości

CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
Count	Pobiera liczbę elementów zawartych w tym elemecie FreezableCollection<T>.
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
HasAnimatedProperties	Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable)
IsFrozen	Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Item[Int32]	Pobiera lub ustawia element pod określonym indeksem.

Metody

Add(T)	Dodaje określony obiekt na końcu obiektu FreezableCollection<T>.
ApplyAnimationClock(DependencyProperty, AnimationClock)	Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior wartość . (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, SnapshotAndReplace zostanie użyte zachowanie przekazywania. (Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior właściwość. (Odziedziczone po Animatable)
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
Clear()	Usuwa wszystkie elementy z kolekcji.
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon tego FreezableCollection<T> i jego zawartości, tworząc głębokie kopie. Jeśli ta kolekcja (lub jej zawartość) ma animowane właściwości zależności, wartość podstawowa właściwości zostanie skopiowana, a nie jego bieżąca animowana wartość.
CloneCore(Freezable)	Sprawia, że to wystąpienie jest klonem (kopią głęboką) określonej wartości FreezableCollection<T> właściwości przy użyciu wartości właściwości base (nie animowanych).
CloneCurrentValue()	Tworzy modyfikowalną kopię tego FreezableCollection<T> i jego zawartości, tworząc głębokie kopie bieżących wartości tego obiektu. Jeśli ten obiekt (lub obiekty, które zawiera) zawiera animowane właściwości zależności, są kopiowane ich bieżące animowane wartości.
CloneCurrentValueCore(Freezable)	Sprawia, że to wystąpienie jest modyfikowalny klon (kopia głęboka) określonego FreezableCollection<T> przy użyciu bieżących wartości właściwości.
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Contains(T)	Określa, czy zawiera FreezableCollection<T> on określoną wartość.
CopyTo(T[], Int32)	Kopiuje całą FreezableCollection<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Tworzy nowe wystąpienie klasy FreezableCollection<T>.
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
Freeze()	Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego IsFrozen właściwość na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, że ten FreezableCollection<T> obiekt jest niezmodyfikowalny lub określa, czy można go niemodyfikować.
GetAnimationBaseValue(DependencyProperty)	Zwraca wartość nie animowaną określonego DependencyPropertyelementu . (Odziedziczone po Animatable)
GetAsFrozen()	Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)	Sprawia, że to wystąpienie jest zamrożonym klonem określonej FreezableCollection<T> wartości właściwości przy użyciu wartości właściwości base (nie animowanych).
GetCurrentValueAsFrozen()	Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Sprawia, że to wystąpienie jest zamrożonym klonem określonego Freezableobiektu . Jeśli ten obiekt ma animowane właściwości zależności, zostaną skopiowane ich bieżące animowane wartości.
GetEnumerator()	Zwraca moduł wyliczający dla całego FreezableCollection<T>elementu .
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
IndexOf(T)	Wyszukuje określony obiekt i zwraca indeks zerowy pierwszego wystąpienia w całym FreezableCollection<T>obiekcie .
Insert(Int32, T)	Wstawia określony obiekt do określonego FreezableCollection<T> indeksu.
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnChanged()	Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Zastępuje implementację DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
ReadPreamble()	Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)
Remove(T)	Usuwa pierwsze wystąpienie określonego obiektu z obiektu FreezableCollection<T>.
RemoveAt(Int32)	Usuwa obiekt w określonym indeksie zerowym elementu FreezableCollection<T>.
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
WritePostscript()	Changed Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable)
WritePreamble()	Sprawdza, czy Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Aby uzyskać opis tego elementu członkowskiego, zobacz CopyTo(Array, Int32).
ICollection.IsSynchronized	Aby uzyskać opis tego elementu członkowskiego, zobacz IsSynchronized.
ICollection.SyncRoot	Aby uzyskać opis tego elementu członkowskiego, zobacz SyncRoot.
ICollection<T>.IsReadOnly	Aby uzyskać opis tego elementu członkowskiego, zobacz IsReadOnly.
IEnumerable.GetEnumerator()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetEnumerator().
IEnumerable<T>.GetEnumerator()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetEnumerator().
IList.Add(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz Add(Object).
IList.Contains(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz Contains(Object).
IList.IndexOf(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz IndexOf(Object).
IList.Insert(Int32, Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz Insert(Int32, Object).
IList.IsFixedSize	Aby uzyskać opis tego elementu członkowskiego, zobacz IsFixedSize.
IList.IsReadOnly	Aby uzyskać opis tego elementu członkowskiego, zobacz IsReadOnly.
IList.Item[Int32]	Aby uzyskać opis tego elementu członkowskiego, zobacz Item[Int32].
IList.Remove(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz Remove(Object).
INotifyCollectionChanged.CollectionChanged	Aby uzyskać opis tych elementów członkowskich, zobacz CollectionChanged.
INotifyPropertyChanged.PropertyChanged	Aby uzyskać opis tych elementów członkowskich, zobacz PropertyChanged.

Metody rozszerzania