Share via


UIElementCollection Classe

Définition

Représente une collection ordonnée d’objets 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>
Héritage
Object Platform::Object IInspectable UIElementCollection
Attributs
Implémente

Remarques

Une UIElementCollection est le type d’objet que vous obtenez à partir de la propriété Children d’un Panel. Par exemple, si vous obtenez une valeur à partir de Grid.Children, cette valeur est une instance UIElementCollection. Toutes les propriétés qui utilisent une UIElementCollection dans l’API Windows Runtime sont des propriétés en lecture seule, où la propriété est initialisée avec zéro élément lorsqu’un objet est instancié pour la première fois. Mais vous pouvez ensuite ajouter, supprimer ou interroger des éléments dans la collection au moment de l’exécution, à l’aide des propriétés et méthodes UIElementCollection.

Le type des éléments dans UIElementCollection est limité en tant qu’UIElement. UiElement étant une classe d’éléments de base dans Windows Runtime à l’aide de XAML, il existe des centaines de types d’éléments qui peuvent être traités comme un UIElement et peuvent donc être l’un des éléments d’une UIElementCollection.

Énumération de la collection en C# ou Microsoft Visual Basic

Une UIElementCollection étant énumérable, vous pouvez utiliser une syntaxe propre au langage, telle que foreach en C# pour énumérer les éléments dans UIElementCollection. Le compilateur effectue le casting de type pour vous et vous n’aurez pas besoin de caster IEnumerable<UIElement> explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable avec une contrainte UIElement .

Propriétés

Size

Obtient la taille (nombre) de la collection.

Méthodes

Append(UIElement)

Ajoute un nouvel élément à la collection.

Clear()

Supprime tous les éléments de la collection.

First()

Retourne l’objet itérateur qui peut itérer sur les éléments de l’UIElementCollection.

GetAt(UInt32)

Retourne l’élément situé à l’index spécifié.

GetMany(UInt32, UIElement[])

Récupère plusieurs éléments en un seul passage par l’itérateur.

GetView()

Obtient une vue immuable dans la collection.

IndexOf(UIElement, UInt32)

Récupère l’index de l’élément spécifié.

InsertAt(UInt32, UIElement)

Insère l’élément spécifié à l’index spécifié.

Move(UInt32, UInt32)

Déplace l'élément situé à l'index spécifié vers un nouvel emplacement dans la collection.

RemoveAt(UInt32)

Supprime l'élément à l'index spécifié.

RemoveAtEnd()

Supprime le dernier élément de la collection.

ReplaceAll(UIElement[])

Efface initialement la collection, puis insère le tableau fourni en tant que nouveaux éléments.

SetAt(UInt32, UIElement)

Définit la valeur à l’index spécifié sur la valeur UIElement spécifiée.

S’applique à

Voir aussi