UIElementCollection Classe

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Représente une collection ordonnée d’objets 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>

Héritage

Object Platform::Object IInspectable UIElementCollection

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

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 de Grid.Children, cette valeur est une instance UIElementCollection. Toutes les propriétés qui utilisent un 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. Mais UIElement étant une classe d’élément 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’un UIElementCollection.

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

Un UIElementCollection étant énumérable, vous pouvez utiliser une syntaxe propre au langage, telle que foreach en C# pour énumérer les éléments de l’UIElementCollection. Le compilateur effectue le cast de type pour vous et vous n’aurez pas besoin d’effectuer un cast IEnumerable<UIElement> vers explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable<T> 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 d’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 une seule passe à travers 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.

Voir aussi

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