UIElementCollection Classe

Definição

Namespace:

Windows.UI.Xaml.Controls

Representa uma coleção 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>

Herança

Object Platform::Object IInspectable UIElementCollection

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

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

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Um UIElementCollection é o tipo de objeto que você obtém da propriedade Children de um Panel. Por exemplo, se você receber um valor de Grid.Children, esse valor será uma instância UIElementCollection. Todas as propriedades que usam um UIElementCollection na API Windows Runtime são propriedades somente leitura, em que a propriedade é inicializada com zero itens quando um objeto é instanciado pela primeira vez. Mas você pode adicionar, remover ou consultar itens na coleção em tempo de execução, usando as propriedades e métodos UIElementCollection.

O tipo dos itens no UIElementCollection é restrito como UIElement. Mas UIElement é uma classe de elemento base em Windows Runtime usando XAML, portanto, há centenas de tipos de elemento que podem ser tratados como um UIElement e, portanto, podem ser um dos itens em um UIElementCollection.

Enumerando a coleção em C# ou Microsoft Visual Basic

Uma UIElementCollection é enumerável, portanto, você pode usar a sintaxe específica da linguagem, como foreach em C#, para enumerar os itens na UIElementCollection. O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable<UIElement> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta para IEnumerable<T> com uma restrição UIElement .

Propriedades

Size	Obtém o tamanho (contagem) da coleção.

Métodos

Append(UIElement)	Adiciona um novo item à coleção.
Clear()	Remove todos os itens da coleção.
First()	Retorna o objeto iterador que pode iterar sobre os itens na UIElementCollection.
GetAt(UInt32)	Retorna o item localizado no índice especificado.
GetMany(UInt32, UIElement[])	Recupera vários elementos em uma única passagem pelo iterador.
GetView()	Obtém uma exibição imutável na coleção.
IndexOf(UIElement, UInt32)	Recupera o índice do item especificado.
InsertAt(UInt32, UIElement)	Insere o item especificado no índice especificado.
Move(UInt32, UInt32)	Move um item no índice especificado para um novo local na coleção.
RemoveAt(UInt32)	Remove o item no índice especificado.
RemoveAtEnd()	Remove o último item da coleção.
ReplaceAll(UIElement[])	Inicialmente limpa a coleção e insere a matriz fornecida como novos itens.
SetAt(UInt32, UIElement)	Define o valor no índice especificado como o valor UIElement especificado.

Confira também

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