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 в разделе Подробные сведения о синтаксисе 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)	Переопределяет реализацию DependencyObject для OnPropertyChanged(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.

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