UIElementCollection Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Representa una colección ordenada de objetos UIElement .

public ref class UIElementCollection sealed : IIterable<UIElement ^>, IVector<UIElement ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UIElementCollection final : IIterable<UIElement>, IVector<UIElement>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class UIElementCollection : IEnumerable<UIElement>, IList<UIElement>

Public NotInheritable Class UIElementCollection
Implements IEnumerable(Of UIElement), IList(Of UIElement)

<panelobject>
  oneOrMoreChildren
</panelobject>

Herencia

Object Platform::Object IInspectable UIElementCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IIterable<T> IEnumerable<T> IIterable<UIElement> IEnumerable<UIElement> IVector<UIElement> IList<UIElement>

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

UiElementCollection es el tipo de objeto que se obtiene de la propiedad Children de un Panel. Por ejemplo, si obtiene un valor de Grid.Children, ese valor es una instancia UIElementCollection. Todas las propiedades que usan uiElementCollection en la API de Windows Runtime son propiedades de solo lectura, donde la propiedad se inicializa con cero elementos cuando se crea una instancia por primera vez de un objeto. Sin embargo, puede agregar, quitar o consultar elementos de la colección en tiempo de ejecución mediante las propiedades y métodos UIElementCollection.

El tipo de los elementos de UIElementCollection está restringido como UIElement. Pero UIElement es una clase de elemento base en Windows Runtime mediante XAML, por lo que hay cientos de tipos de elementos que se pueden tratar como uiElement y, por tanto, pueden ser uno de los elementos de una UIElementCollection.

Enumeración de la colección en C# o Microsoft Visual Basic

UiElementCollection es enumerable, por lo que puede usar sintaxis específica del lenguaje, como foreach en C# para enumerar los elementos de UIElementCollection. El compilador realiza la conversión de tipos automáticamente y no es necesario convertir a IEnumerable<UIElement> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta en IEnumerable<T> con una restricción UIElement .

Propiedades

Size	Obtiene el tamaño (recuento) de la colección.

Métodos

Append(UIElement)	Agrega un nuevo elemento a la colección.
Clear()	Quita todos los elementos de la colección.
First()	Devuelve el objeto iterador que puede iterar sobre los elementos de UIElementCollection.
GetAt(UInt32)	Devuelve el elemento ubicado en el índice especificado.
GetMany(UInt32, UIElement[])	Recupera varios elementos en un único paso a través del iterador.
GetView()	Obtiene una vista inmutable en la colección.
IndexOf(UIElement, UInt32)	Recupera el índice del elemento especificado.
InsertAt(UInt32, UIElement)	Inserta el elemento especificado en el índice especificado.
Move(UInt32, UInt32)	Mueve el elemento que se encuentra en el índice especificado a otra ubicación de la colección.
RemoveAt(UInt32)	Quita el elemento del índice especificado.
RemoveAtEnd()	Quita el último elemento de la colección.
ReplaceAll(UIElement[])	Inicialmente borra la colección y, a continuación, inserta la matriz proporcionada como elementos nuevos.
SetAt(UInt32, UIElement)	Establece el valor en el índice especificado en el valor UIElement especificado.

Consulte también

• Children
• IVector<T>
• IIterable<T>
• VisualTreeHelper
• UIElement
• IList< T>