Share via

UIElementCollection Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml.Controls
Editar

Representa uma coleção ordenada de objetos UIElement .

public ref class UIElementCollection sealed : IIterable<UIElement ^>, IVector<UIElement ^>
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UIElementCollection final : IIterable<UIElement>, IVector<UIElement>
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 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<UIElement> IEnumerable<UIElement> IIterable<T> IEnumerable<T> IVector<UIElement> IList<UIElement>

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 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.

Aplica-se a

Confira também