UIElementCollection Klasse

Definition

Namespace:

Windows.UI.Xaml.Controls

Stellt eine geordnete Auflistung von UIElement-Objekten dar.

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>

Vererbung

Object Platform::Object IInspectable UIElementCollection

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

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

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Eine UIElementCollection ist der Objekttyp, den Sie aus der Children-Eigenschaft eines Panels abrufen. Wenn Sie beispielsweise einen Wert von Grid.Children abrufen, ist dieser Wert ein UIElementCollection-instance. Alle Eigenschaften, die eine UIElementCollection in der Windows-Runtime-API verwenden, sind schreibgeschützte Eigenschaften, bei denen die Eigenschaft mit null Elementen initialisiert wird, wenn ein Objekt zuerst instanziiert wird. Sie können der Auflistung dann jedoch zur Laufzeit Elemente hinzufügen, entfernen oder abfragen, indem Sie die UIElementCollection-Eigenschaften und -Methoden verwenden.

Der Typ der Elemente in der UIElementCollection ist als UIElement eingeschränkt. UIElement ist jedoch eine Basiselementklasse in Windows-Runtime, die XAML verwendet. Daher gibt es Hunderte von Elementtypen, die als UIElement behandelt werden können und somit eines der Elemente in einer UIElementCollection sein können.

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Eine UIElementCollection ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der UIElementCollection aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<UIElement> umgewandelt werden. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer UIElement-Einschränkung in IEnumerable<T> um.

Eigenschaften

Size	Ruft die Größe (Anzahl) der Auflistung ab.

Methoden

Append(UIElement)	Fügt der Auflistung ein neues Element hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
First()	Gibt das Iteratorobjekt zurück, das die Elemente in der UIElementCollection durchlaufen kann.
GetAt(UInt32)	Gibt das Element zurück, das sich am angegebenen Index befindet.
GetMany(UInt32, UIElement[])	Ruft mehrere Elemente in einem einzelnen Durchgang durch den Iterator ab.
GetView()	Ruft eine unveränderliche Ansicht in die Auflistung ab.
IndexOf(UIElement, UInt32)	Ruft den Index des angegebenen Elements ab.
InsertAt(UInt32, UIElement)	Fügt das angegebene Element am angegebenen Index ein.
Move(UInt32, UInt32)	Verschiebt das Element am angegebenen Index an eine neue Position in der Auflistung.
RemoveAt(UInt32)	Entfernt das Element am angegebenen Index.
RemoveAtEnd()	Entfernt das letzte Element in der Auflistung.
ReplaceAll(UIElement[])	Löscht zunächst die Auflistung und fügt dann das bereitgestellte Array als neue Elemente ein.
SetAt(UInt32, UIElement)	Legt den Wert am angegebenen Index auf den angegebenen UIElement-Wert fest.

Weitere Informationen

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