FreezableCollection<T> Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Representa uma coleção de objetos DependencyObject, Freezableou Animatable. FreezableCollection<T> é um tipo 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

Parâmetros de tipo

T

O tipo de coleção. Esse tipo deve ser um DependencyObject ou uma classe derivada.

Herança

Object

DispatcherObject

DependencyObject

Freezable

Animatable

FreezableCollection<T>

Derivado

System.Windows.Controls.Ribbon.RibbonControlSizeDefinitionCollection

System.Windows.Controls.Ribbon.RibbonGroupSizeDefinitionBaseCollection

System.Windows.Shell.ThumbButtonInfoCollection

Implementações

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

Comentários

Essa classe é fornecida para habilitar a criação de tipos de coleção personalizados que dão suporte total à associação de dados, à notificação de alteração, à invalidação de propriedade e à animação de seu conteúdo.

Uso de XAML para FreezableCollection

FreezableCollection<T> dá suporte a uma sintaxe XAML limitada.

• Como um elemento de objeto na raiz, você pode teoricamente especificar um elemento de objeto FreezableCollection<T> não treinado, que também deve especificar a diretiva x:TypeArguments para declarar a restrição. No entanto, esse não é um cenário comum, pois para fazer isso, o FreezableCollection<T> deve ser o elemento raiz. Essa limitação existe porque a implementação do processador XAML no WPF só pode dar suporte a diretiva x:TypeArguments quando o elemento em que ele está sendo definido é o elemento raiz e você deve usar em qualquer genérico de restrição aberta se quiser criar uma instância de um tipo genérico no XAML. É improvável que você queira um FreezableCollection<T> como o elemento raiz, mesmo que XAML flexível.

• Se você derivar de FreezableCollection<T> e aplicar uma restrição de tipo na coleção derivada, a coleção derivada poderá dar suporte a uma variedade de usos. Isso é possível porque a restrição em sua derivação elimina a necessidade de passar.

  • O uso típico de XAML para essa coleção derivada é por meio da sintaxe de coleção implícita. Coleções que dão suporte a determinadas interfaces não precisam especificar a coleção em si como um elemento de objeto. Para obter detalhes sobre a sintaxe da coleção em XAML, consulte sintaxe XAML em detalhes. Por exemplo, um objeto com uma propriedade em que a propriedade era do tipo FreezableCollection<T> restringida por DependencyObject poderia dar suporte à seguinte sintaxe:

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

  • Desde que você não oculte o construtor sem parâmetros, a coleção derivada também pode dar suporte a uma sintaxe de elemento de objeto (em que o elemento objeto é explícito, em oposição ao uso implícito mostrado acima). Ele não precisa ser o elemento raiz. Ou você também pode usar a coleção derivada como um elemento raiz, sem precisar especificar, embora o uso de uma coleção como elemento raiz seja incomum.

• Qualquer elemento filho da coleção em qualquer um dos cenários acima deve ser do tipo da restrição implementada ou conforme especificado por .

Construtores

FreezableCollection<T>()	Inicializa uma nova instância de FreezableCollection<T> que está vazia e tem a capacidade inicial padrão.
FreezableCollection<T>(IEnumerable<T>)	Inicializa uma nova instância da classe FreezableCollection<T> que contém os mesmos elementos da coleção especificada.
FreezableCollection<T>(Int32)	Inicializa uma nova instância do FreezableCollection<T> que está vazia e tem a capacidade inicial especificada.

Propriedades

CanFreeze	Obtém um valor que indica se o objeto pode ser tornado inmodificável. (Herdado de Freezable)
Count	Obtém o número de elementos contidos neste FreezableCollection<T>.
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual esse DispatcherObject está associado. (Herdado de DispatcherObject)
HasAnimatedProperties	Obtém um valor que indica se um ou mais objetos AnimationClock estão associados a qualquer uma das propriedades de dependência desse objeto. (Herdado de Animatable)
IsFrozen	Obtém um valor que indica se o objeto é modificável no momento. (Herdado de Freezable)
IsSealed	Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject)
Item[Int32]	Obtém ou define o elemento no índice especificado.

Métodos

Add(T)	Adiciona o objeto especificado ao final do FreezableCollection<T>.
ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica um AnimationClock ao DependencyPropertyespecificado. Se a propriedade já estiver animada, o comportamento de entrega SnapshotAndReplace será usado. (Herdado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica um AnimationClock ao DependencyPropertyespecificado. Se a propriedade já estiver animada, o HandoffBehavior especificado será usado. (Herdado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica uma animação ao DependencyPropertyespecificado. A animação é iniciada quando o próximo quadro é renderizado. Se a propriedade especificada já estiver animada, o comportamento de entrega SnapshotAndReplace será usado. (Herdado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica uma animação ao DependencyPropertyespecificado. A animação é iniciada quando o próximo quadro é renderizado. Se a propriedade especificada já estiver animada, o HandoffBehavior especificado será usado. (Herdado de Animatable)
CheckAccess()	Determina se o thread de chamada tem acesso a esse DispatcherObject. (Herdado de DispatcherObject)
Clear()	Remove todos os elementos da coleção.
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um identificador de DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
Clone()	Cria um clone modificável desse FreezableCollection<T> e seu conteúdo, fazendo cópias profundas. Se essa coleção (ou seu conteúdo) tiver propriedades de dependência animadas, o valor base da propriedade será copiado, não seu valor animado atual.
CloneCore(Freezable)	Torna essa instância um clone (cópia profunda) do FreezableCollection<T> especificado usando valores de propriedade base (não animados).
CloneCurrentValue()	Cria uma cópia modificável desse FreezableCollection<T> e seu conteúdo, fazendo cópias profundas dos valores atuais desse objeto. Se esse objeto (ou os objetos que ele contém) contiver propriedades de dependência animadas, seus valores animados atuais serão copiados.
CloneCurrentValueCore(Freezable)	Torna essa instância um clone modificável (cópia profunda) do FreezableCollection<T> especificado usando valores de propriedade atuais.
CoerceValue(DependencyProperty)	Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função de CoerceValueCallback especificada em metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject)
Contains(T)	Determina se esse FreezableCollection<T> contém o valor especificado.
CopyTo(T[], Int32)	Copia toda a FreezableCollection<T> para uma matriz unidimensional compatível, começando no índice especificado da matriz de destino.
CreateInstance()	Inicializa uma nova instância da classe Freezable. (Herdado de Freezable)
CreateInstanceCore()	Cria uma nova instância do FreezableCollection<T>.
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObjectatual. (Herdado de DependencyObject)
Freeze()	Torna o objeto atual inmodificável e define sua propriedade IsFrozen como true. (Herdado de Freezable)
FreezeCore(Boolean)	Torna esse objeto FreezableCollection<T> inmodificável ou determina se ele pode se tornar inmodificável.
GetAnimationBaseValue(DependencyProperty)	Retorna o valor não animado do DependencyPropertyespecificado. (Herdado de Animatable)
GetAsFrozen()	Cria uma cópia congelada do Freezable, usando valores de propriedade base (não animados). Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência. (Herdado de Freezable)
GetAsFrozenCore(Freezable)	Torna essa instância um clone congelado do FreezableCollection<T> especificado usando valores de propriedade base (não animados).
GetCurrentValueAsFrozen()	Cria uma cópia congelada do Freezable usando valores de propriedade atuais. Como a cópia está congelada, todos os sub-objetos congelados são copiados por referência. (Herdado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Torna essa instância um clone congelado do Freezableespecificado. Se esse objeto tiver propriedades de dependência animadas, seus valores animados atuais serão copiados.
GetEnumerator()	Retorna um enumerador para todo o FreezableCollection<T>.
GetHashCode()	Obtém um código hash para este DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente neste DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject)
IndexOf(T)	Pesquisa o objeto especificado e retorna o índice baseado em zero da primeira ocorrência em todo o FreezableCollection<T>.
Insert(Int32, T)	Insere o objeto especificado no FreezableCollection<T> no índice especificado.
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnChanged()	Chamado quando o objeto Freezable atual é modificado. (Herdado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garante que os ponteiros de contexto apropriados sejam estabelecidos para um membro de dados DependencyObjectType que acabou de ser definido. (Herdado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código. (Herdado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Substitui a implementação DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar também os manipuladores de Changed em resposta a uma propriedade de dependência variável do tipo Freezable. (Herdado de Freezable)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject)
ReadPreamble()	Garante que o Freezable esteja sendo acessado de um thread válido. Os herdadores de Freezable devem chamar esse método no início de qualquer API que leia os membros de dados que não são propriedades de dependência. (Herdado de Freezable)
Remove(T)	Remove a primeira ocorrência do objeto especificado do FreezableCollection<T>.
RemoveAt(Int32)	Remove o objeto no índice de base zero especificado do FreezableCollection<T>.
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a esse DispatcherObject. (Herdado de DispatcherObject)
WritePostscript()	Gera o evento Changed para o Freezable e invoca seu método OnChanged(). Classes que derivam de Freezable devem chamar esse método no final de qualquer API que modifique os membros da classe que não são armazenados como propriedades de dependência. (Herdado de Freezable)
WritePreamble()	Verifica se o Freezable não está congelado e se está sendo acessado de um contexto de threading válido. Freezable herdadores devem chamar esse método no início de qualquer API que grava em membros de dados que não são propriedades de dependência. (Herdado de Freezable)

Eventos

Changed

Ocorre quando o Freezable ou um objeto que ele contém é modificado. (Herdado de Freezable)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Para obter uma descrição desse membro, consulte CopyTo(Array, Int32).
ICollection.IsSynchronized	Para obter uma descrição desse membro, consulte IsSynchronized.
ICollection.SyncRoot	Para obter uma descrição desse membro, consulte SyncRoot.
ICollection<T>.IsReadOnly	Para obter uma descrição desse membro, consulte IsReadOnly.
IEnumerable.GetEnumerator()	Para obter uma descrição desse membro, consulte GetEnumerator().
IEnumerable<T>.GetEnumerator()	Para obter uma descrição desse membro, consulte GetEnumerator().
IList.Add(Object)	Para obter uma descrição desse membro, consulte Add(Object).
IList.Contains(Object)	Para obter uma descrição desse membro, consulte Contains(Object).
IList.IndexOf(Object)	Para obter uma descrição desse membro, consulte IndexOf(Object).
IList.Insert(Int32, Object)	Para obter uma descrição desse membro, consulte Insert(Int32, Object).
IList.IsFixedSize	Para obter uma descrição desse membro, consulte IsFixedSize.
IList.IsReadOnly	Para obter uma descrição desse membro, consulte IsReadOnly.
IList.Item[Int32]	Para obter uma descrição desse membro, consulte Item[Int32].
IList.Remove(Object)	Para obter uma descrição desse membro, consulte Remove(Object).
INotifyCollectionChanged.CollectionChanged	Para obter uma descrição desses membros, consulte CollectionChanged.
INotifyPropertyChanged.PropertyChanged	Para obter uma descrição desses membros, consulte PropertyChanged.

Métodos de Extensão