UIElementCollection Classe

Référence

Définition

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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 une collection 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 utilisant XAML, il existe des centaines de types d’éléments qui peuvent être traités comme 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 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.

S’applique à

Partager via