FreezableCollection<T> Класс

Определение

Пространство имен:

System.Windows

Сборка:

PresentationCore.dll

Представляет коллекцию объектов DependencyObject, Freezableили Animatable. FreezableCollection<T> сам тип 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

Параметры типа

T

Тип коллекции. Этот тип должен быть DependencyObject или производным классом.

Наследование

Object

DispatcherObject

DependencyObject

Freezable

Animatable

FreezableCollection<T>

Производный

System.Windows.Controls.Ribbon.RibbonControlSizeDefinitionCollection

System.Windows.Controls.Ribbon.RibbonGroupSizeDefinitionBaseCollection

System.Windows.Shell.ThumbButtonInfoCollection

Реализации

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

Комментарии

Этот класс предоставляется для создания пользовательских типов коллекций, которые полностью поддерживают привязку данных, уведомление об изменении, недопустимость свойств и анимацию его содержимого.

Использование XAML для FreezableCollection

FreezableCollection<T> поддерживает ограниченный синтаксис XAML.

• В качестве элемента объекта в корневом каталоге можно теоретически указать элемент объекта без ограничений FreezableCollection<T>, который также должен указывать директиву x:TypeArguments, чтобы объявить ограничение. Однако это не распространенный сценарий, так как для этого FreezableCollection<T> должен быть корневым элементом. Это ограничение существует, так как реализация обработчика XAML в WPF может поддерживать только директивы x:TypeArguments, если элемент, на который он установлен, является корневым элементом, и необходимо использовать для любого универсального ограничения, если требуется создать экземпляр универсального типа в XAML. Маловероятно, что вы хотите FreezableCollection<T> в качестве корневого элемента, даже как свободный XAML.

• Если вы наследуете от FreezableCollection<T> и применяете ограничение типа в производной коллекции, производная коллекция может поддерживать различные виды использования. Это возможно, так как ограничение в производном элементе устраняет необходимость передачи.

  • Обычное использование XAML для такой производной коллекции осуществляется с помощью неявного синтаксиса коллекции. Коллекции, поддерживающие определенные интерфейсы, не должны указывать саму коллекцию в качестве элемента объекта. Дополнительные сведения о синтаксисе коллекции в XAML см. в синтаксисе XAML в подробной. Например, объект со свойством , где свойство типа FreezableCollection<T> ограничено DependencyObject может поддерживать следующий синтаксис:

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

  • Если вы не скрываете конструктор без параметров, производная коллекция также может поддерживать синтаксис элемента объекта (где элемент объекта явный, а неявное использование, показанное выше). Он не должен быть корневым элементом. Кроме того, можно использовать производную коллекцию в качестве корневого элемента без необходимости указывать, хотя использование коллекции в качестве корневого элемента редко.

• Любые дочерние элементы коллекции в любом из приведенных выше сценариев должны иметь тип реализованного ограничения или, как указано в параметре.

Конструкторы

FreezableCollection<T>()	Инициализирует новый экземпляр FreezableCollection<T>, который пуст и имеет начальную емкость по умолчанию.
FreezableCollection<T>(IEnumerable<T>)	Инициализирует новый экземпляр класса FreezableCollection<T>, который содержит те же элементы, что и указанная коллекция.
FreezableCollection<T>(Int32)	Инициализирует новый экземпляр FreezableCollection<T>, пустой и имеющий указанную начальную емкость.

Свойства

CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
Count	Возвращает количество элементов, содержащихся в этом FreezableCollection<T>.
DependencyObjectType	Возвращает DependencyObjectType, который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Возвращает Dispatcher, с которым связан этот DispatcherObject. (Унаследовано от DispatcherObject)
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько объектов AnimationClock с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Item[Int32]	Возвращает или задает элемент по указанному индексу.

Методы

Add(T)	Добавляет указанный объект в конец FreezableCollection<T>.
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяет AnimationClock к указанному DependencyProperty. Если свойство уже анимировано, используется SnapshotAndReplace поведение передачи. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяет AnimationClock к указанному DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется поведение SnapshotAndReplace передачи. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior. (Унаследовано от Animatable)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
Clear()	Удаляет все элементы из коллекции.
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty. (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство для очистки указывается DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает модификаторный клон этого FreezableCollection<T> и его содержимого, делая глубокие копии. Если эта коллекция (или ее содержимое) имеет анимированные свойства зависимостей, базовое значение свойства копируется, а не его текущее анимированное значение.
CloneCore(Freezable)	Делает этот экземпляр клоном (глубокой копией) указанного FreezableCollection<T> с использованием базовых (не анимированных) значений свойств.
CloneCurrentValue()	Создает модификируемую копию этого FreezableCollection<T> и его содержимого, делая глубокие копии текущих значений этого объекта. Если этот объект (или объекты, содержащиеся в нем) содержит анимированные свойства зависимостей, их текущие анимированные значения копируются.
CloneCurrentValueCore(Freezable)	Делает этот экземпляр модификируемым клоном (глубокой копией) указанного FreezableCollection<T> с использованием текущих значений свойств.
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой функции CoerceValueCallback, указанной в метаданных свойства для свойства зависимостей, так как он существует в вызывающей DependencyObject. (Унаследовано от DependencyObject)
Contains(T)	Определяет, содержит ли этот FreezableCollection<T> указанное значение.
CopyTo(T[], Int32)	Копирует весь FreezableCollection<T> в совместимый одномерный массив, начиная с указанного индекса целевого массива.
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	Создает новый экземпляр FreezableCollection<T>.
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства IsFrozen значение true. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает этот объект FreezableCollection<T> неизменимым или определяет, может ли он быть изменен.
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию Freezable, используя базовые (не анимированные) значения свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает этот экземпляр замороженным клоном указанного FreezableCollection<T> с использованием базовых (не анимированных) значений свойств.
GetCurrentValueAsFrozen()	Создает замороженную копию Freezable с использованием текущих значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает этот экземпляр замороженным клоном указанного Freezable. Если этот объект имеет анимированные свойства зависимостей, их текущие анимированные значения копируются.
GetEnumerator()	Возвращает перечислитель для всего FreezableCollection<T>.
GetHashCode()	Возвращает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
IndexOf(T)	Выполняет поиск указанного объекта и возвращает отсчитываемый от нуля индекс первого вхождения в пределах всего FreezableCollection<T>.
Insert(Int32, T)	Вставляет указанный объект в FreezableCollection<T> по указанному индексу.
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего объекта Freezable. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных DependencyObjectType только что заданы соответствующие указатели контекста. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет реализацию DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех обработчиков Changed в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует, что доступ к Freezable осуществляется из допустимого потока. Наследующие Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)
Remove(T)	Удаляет первое вхождение указанного объекта из FreezableCollection<T>.
RemoveAt(Int32)	Удаляет объект по указанному отсчитываемой от нуля индексу FreezableCollection<T>.
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное идентификатором DependencyPropertyKey свойства зависимостей. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
VerifyAccess()	Принудительно применяет доступ к этому DispatcherObjectвызываемого потока. (Унаследовано от DispatcherObject)
WritePostscript()	Вызывает событие Changed для Freezable и вызывает его метод OnChanged(). Классы, производные от Freezable, должны вызывать этот метод в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что Freezable не заморожен и к которому осуществляется доступ из допустимого контекста потоков. Freezable наследующие должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)

События

Changed

Происходит при изменении Freezable или объекта, содержащего его. (Унаследовано от Freezable)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)	Описание этого элемента см. в разделе CopyTo(Array, Int32).
ICollection.IsSynchronized	Описание этого элемента см. в разделе IsSynchronized.
ICollection.SyncRoot	Описание этого элемента см. в разделе SyncRoot.
ICollection<T>.IsReadOnly	Описание этого элемента см. в разделе IsReadOnly.
IEnumerable.GetEnumerator()	Описание этого элемента см. в разделе GetEnumerator().
IEnumerable<T>.GetEnumerator()	Описание этого элемента см. в разделе GetEnumerator().
IList.Add(Object)	Описание этого элемента см. в разделе Add(Object).
IList.Contains(Object)	Описание этого элемента см. в разделе Contains(Object).
IList.IndexOf(Object)	Описание этого элемента см. в разделе IndexOf(Object).
IList.Insert(Int32, Object)	Описание этого элемента см. в разделе Insert(Int32, Object).
IList.IsFixedSize	Описание этого элемента см. в разделе IsFixedSize.
IList.IsReadOnly	Описание этого элемента см. в разделе IsReadOnly.
IList.Item[Int32]	Описание этого элемента см. в разделе Item[Int32].
IList.Remove(Object)	Описание этого элемента см. в разделе Remove(Object).
INotifyCollectionChanged.CollectionChanged	Описание этих элементов см. в разделе CollectionChanged.
INotifyPropertyChanged.PropertyChanged	Описание этих элементов см. в разделе PropertyChanged.

Методы расширения