Langage

UIElementCollection Classe

Définition

Espace de noms:
Microsoft.UI.Xaml.Controls
Modifier

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
ContractVersionAttribute MarshalingBehaviorAttribute
Implémente
IIterable<UIElement> IEnumerable<UIElement> IIterable<T> IEnumerable<T> IVector<UIElement> IList<UIElement>

Remarques

Un UIElementCollection est le type d’objet que vous obtenez à partir de la propriété Children d’un Panneau. Par exemple, si vous obtenez une valeur à partir de Grid.Children, cette valeur est une instance UIElementCollection. Toutes les propriétés qui utilisent 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. Toutefois, 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 est une classe d’élément de base dans Windows Runtime à l’aide de XAML. Il existe donc 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#

Un UIElementCollection est énumérable. Vous pouvez donc utiliser une syntaxe spécifique au langage telle que foreach en C# pour énumérer les éléments dans UIElementCollection. Le compilateur effectue le cast de type pour vous et vous n’aurez pas besoin de caster IEnumerable<UIElement> explicitement. Si vous devez effectuer un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast vers IEnumerable<T> avec une contrainte UIElement .

Propriétés

Nom Description
Size

Obtient la taille (nombre) de la collection.

Méthodes

Nom Description
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 dans UIElementCollection.
GetAt(UInt32)

Retourne l’élément situé à l’index spécifié.
GetMany(UInt32, UIElement[])

Récupère plusieurs éléments dans une seule passe via 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 à 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