FreezableCollection<T> Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Representa una colección de objetos DependencyObject, Freezableo Animatable. FreezableCollection<T> es un tipo de 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

Tipo de colección. Este tipo debe ser un DependencyObject o una clase derivada.

Herencia

Object

DispatcherObject

DependencyObject

Freezable

Animatable

FreezableCollection<T>

Derivado

System.Windows.Controls.Ribbon.RibbonControlSizeDefinitionCollection

System.Windows.Controls.Ribbon.RibbonGroupSizeDefinitionBaseCollection

System.Windows.Shell.ThumbButtonInfoCollection

Implementaciones

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

Comentarios

Esta clase se proporciona para habilitar la creación de tipos de colección personalizados que admiten completamente el enlace de datos, la notificación de cambios, la invalidación de propiedades y la animación de su contenido.

Uso de XAML para FreezableCollection

FreezableCollection<T> admite una sintaxis XAML limitada.

• Como elemento de objeto en la raíz, en teoría puede especificar un elemento de objeto FreezableCollection<T> sin restricciones, que también debe especificar la directiva x:TypeArguments para declarar la restricción. Sin embargo, esto no es un escenario común, ya que para ello, el FreezableCollection<T> debe ser el elemento raíz. Esta limitación existe porque la implementación del procesador XAML en WPF solo puede admitir directiva x:TypeArguments cuando el elemento en el que se establece es el elemento raíz y debe usar en cualquier restricción abierta genérica si desea crear una instancia de un tipo genérico en XAML. Es poco probable que quieras un FreezableCollection<T> como elemento raíz, incluso como XAML flexible.

• Si deriva de FreezableCollection<T> y aplica una restricción de tipo en la colección derivada, la colección derivada puede admitir una variedad de usos. Esto es posible porque la restricción de la derivación elimina la necesidad de pasar .

  • El uso típico de XAML para esta colección derivada es a través de la sintaxis de colección implícita. Las colecciones que admiten determinadas interfaces no necesitan especificar la propia colección como un elemento de objeto. Para obtener más información sobre la sintaxis de colección en XAML, consulta sintaxis XAML en detalle. Por ejemplo, un objeto con una propiedad donde la propiedad era de tipo FreezableCollection<T> restringida por DependencyObject podría admitir la sintaxis siguiente:

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

  • Siempre que no oculte el constructor sin parámetros, la colección derivada también puede admitir una sintaxis de elemento de objeto (donde el elemento de objeto es explícito, en lugar del uso implícito mostrado anteriormente). No es necesario ser el elemento raíz. O bien, también puede usar la colección derivada como un elemento raíz, sin necesidad de especificar , aunque el uso de una colección como elemento raíz es poco común.

• Los elementos secundarios de la colección en cualquiera de los escenarios anteriores deben ser del tipo de restricción implementada o según lo especificado por .

Constructores

FreezableCollection<T>()	Inicializa una nueva instancia de FreezableCollection<T> que está vacía y tiene la capacidad inicial predeterminada.
FreezableCollection<T>(IEnumerable<T>)	Inicializa una nueva instancia de la clase FreezableCollection<T> que contiene los mismos elementos que la colección especificada.
FreezableCollection<T>(Int32)	Inicializa una nueva instancia del FreezableCollection<T> que está vacía y tiene la capacidad inicial especificada.

Propiedades

CanFreeze	Obtiene un valor que indica si el objeto se puede hacer no modificable. (Heredado de Freezable)
Count	Obtiene el número de elementos contenidos en este FreezableCollection<T>.
DependencyObjectType	Obtiene el DependencyObjectType que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el Dispatcher al que está asociado este DispatcherObject. (Heredado de DispatcherObject)
HasAnimatedProperties	Obtiene un valor que indica si uno o varios objetos AnimationClock están asociados a cualquiera de las propiedades de dependencia de este objeto. (Heredado de Animatable)
IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente. (Heredado de Freezable)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura). (Heredado de DependencyObject)
Item[Int32]	Obtiene o establece el elemento en el índice especificado.

Métodos

Add(T)	Agrega el objeto especificado al final del FreezableCollection<T>.
ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica un AnimationClock al DependencyPropertyespecificado. Si la propiedad ya está animada, se usa el HandoffBehavior especificado. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación al DependencyPropertyespecificado. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el SnapshotAndReplace comportamiento de entrega. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación al DependencyPropertyespecificado. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el HandoffBehavior especificado. (Heredado de Animatable)
CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
Clear()	Quita todos los elementos de la colección.
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. El identificador de DependencyProperty especifica la propiedad que se va a borrar. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. Un DependencyPropertyKeyespecifica la propiedad que se va a borrar. (Heredado de DependencyObject)
Clone()	Crea un clon modificable de este FreezableCollection<T> y su contenido, haciendo copias en profundidad. Si esta colección (o su contenido) tiene propiedades de dependencia animadas, se copia el valor base de la propiedad, no su valor animado actual.
CloneCore(Freezable)	Convierte esta instancia en un clon (copia profunda) del FreezableCollection<T> especificado mediante valores de propiedad base (no animados).
CloneCurrentValue()	Crea una copia modificable de este FreezableCollection<T> y su contenido, haciendo copias profundas de los valores actuales de este objeto. Si este objeto (o los objetos que contiene) contiene propiedades de dependencia animadas, se copian sus valores animados actuales.
CloneCurrentValueCore(Freezable)	Convierte esta instancia en un clon modificable (copia profunda) del FreezableCollection<T> especificado mediante los valores de propiedad actuales.
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función de CoerceValueCallback especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada a DependencyObject. (Heredado de DependencyObject)
Contains(T)	Determina si este FreezableCollection<T> contiene el valor especificado.
CopyTo(T[], Int32)	Copia toda la FreezableCollection<T> en una matriz unidimensional compatible, empezando por el índice especificado de la matriz de destino.
CreateInstance()	Inicializa una nueva instancia de la clase Freezable. (Heredado de Freezable)
CreateInstanceCore()	Crea una nueva instancia del FreezableCollection<T>.
Equals(Object)	Determina si un DependencyObject proporcionado es equivalente al DependencyObjectactual. (Heredado de DependencyObject)
Freeze()	Hace que el objeto actual no se pueda modificar y establezca su propiedad IsFrozen en true. (Heredado de Freezable)
FreezeCore(Boolean)	Hace que este objeto FreezableCollection<T> no se pueda modificar o determina si se puede hacer no modificable.
GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado del DependencyPropertyespecificado. (Heredado de Animatable)
GetAsFrozen()	Crea una copia inmovilizada de la Freezable, utilizando valores de propiedad base (no animados). Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Convierte esta instancia en un clon inmovilizado del FreezableCollection<T> especificado mediante valores de propiedad base (no animados).
GetCurrentValueAsFrozen()	Crea una copia inmovilizada del Freezable mediante los valores de propiedad actuales. Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte esta instancia en un clon inmovilizado del Freezableespecificado. Si este objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.
GetEnumerator()	Devuelve un enumerador para toda la FreezableCollection<T>.
GetHashCode()	Obtiene un código hash para este DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
IndexOf(T)	Busca el objeto especificado y devuelve el índice de base cero de la primera aparición dentro de toda la FreezableCollection<T>.
Insert(Int32, T)	Inserta el objeto especificado en el FreezableCollection<T> en el índice especificado.
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnChanged()	Se llama cuando se modifica el objeto Freezable actual. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantiza que los punteros de contexto adecuados se establecen para un miembro de datos de DependencyObjectType que se acaba de establecer. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invalida la implementación de DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también los controladores de Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReadPreamble()	Garantiza que se accede a la Freezable desde un subproceso válido. Los heredadores de Freezable deben llamar a este método al principio de cualquier API que lea miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)
Remove(T)	Quita la primera aparición del objeto especificado de la FreezableCollection<T>.
RemoveAt(Int32)	Quita el objeto en el índice de base cero especificado del FreezableCollection<T>.
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el evento Changed para el Freezable e invoca su método OnChanged(). Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique los miembros de clase que no se almacenan como propiedades de dependencia. (Heredado de Freezable)
WritePreamble()	Comprueba que el Freezable no está inmovilizado y que se accede a él desde un contexto de subproceso válido. Freezable heredar deben llamar a este método al principio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)

Eventos

Changed

Se produce cuando se modifica el Freezable o un objeto que contiene. (Heredado de Freezable)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Para obtener una descripción de este miembro, consulte CopyTo(Array, Int32).
ICollection.IsSynchronized	Para obtener una descripción de este miembro, consulte IsSynchronized.
ICollection.SyncRoot	Para obtener una descripción de este miembro, consulte SyncRoot.
ICollection<T>.IsReadOnly	Para obtener una descripción de este miembro, consulte IsReadOnly.
IEnumerable.GetEnumerator()	Para obtener una descripción de este miembro, consulte GetEnumerator().
IEnumerable<T>.GetEnumerator()	Para obtener una descripción de este miembro, consulte GetEnumerator().
IList.Add(Object)	Para obtener una descripción de este miembro, consulte Add(Object).
IList.Contains(Object)	Para obtener una descripción de este miembro, consulte Contains(Object).
IList.IndexOf(Object)	Para obtener una descripción de este miembro, consulte IndexOf(Object).
IList.Insert(Int32, Object)	Para obtener una descripción de este miembro, consulte Insert(Int32, Object).
IList.IsFixedSize	Para obtener una descripción de este miembro, consulte IsFixedSize.
IList.IsReadOnly	Para obtener una descripción de este miembro, consulte IsReadOnly.
IList.Item[Int32]	Para obtener una descripción de este miembro, consulte Item[Int32].
IList.Remove(Object)	Para obtener una descripción de este miembro, consulte Remove(Object).
INotifyCollectionChanged.CollectionChanged	Para obtener una descripción de estos miembros, vea CollectionChanged.
INotifyPropertyChanged.PropertyChanged	Para obtener una descripción de estos miembros, vea PropertyChanged.

Métodos de extensión