Share via

UIElementCollection Klasse

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Stellt eine geordnete Auflistung von UIElement-Objekten dar.

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>
Vererbung
Object Platform::Object IInspectable UIElementCollection
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute
Implementiert
IIterable<UIElement> IEnumerable<UIElement> IIterable<T> IEnumerable<T> IVector<UIElement> IList<UIElement>

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, werden Sie mit einer UIElement-Einschränkung in IEnumerable umgewandelt.

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.

Gilt für:

Weitere Informationen