UIElementCollection 类

定义

表示 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>
继承
Object Platform::Object IInspectable UIElementCollection
属性
实现

注解

UIElementCollection 是从 PanelChildren 属性获取的对象类型。 例如,如果从 Grid.Children 获取值,该值是 UIElementCollection 实例。 在 Windows 运行时 API 中使用 UIElementCollection 的所有属性都是只读属性,其中属性在首次实例化对象时用零项初始化。 但随后可以使用 UIElementCollection 属性和方法在运行时添加、删除或查询集合中的项。

UIElementCollection 中项的类型被约束为 UIElement。 但是 UIElement 是 Windows 运行时中使用 XAML 的基元素类,因此有数百种元素类型可以被视为 UIElement ,因此可以是 UIElementCollection 中的项之一。

枚举 C# 或 Microsoft Visual Basic 中的集合

UIElementCollection 是可枚举的,因此可以使用特定于语言的语法(例如 C# 中的 foreach )枚举 UIElementCollection 中的项。 编译器为你执行类型强制转换,你无需显式转换为 IEnumerable<UIElement> 。 如果需要显式强制转换(例如,如果要调用 GetEnumerator),请使用 UIElement 约束强制转换为 IEnumerable

属性

Size

获取集合的大小 (计数) 。

方法

Append(UIElement)

将新项添加到集合。

Clear()

从集合中移除所有项。

First()

返回可循环访问 UIElementCollection 中的项的迭代器对象。

GetAt(UInt32)

返回位于指定索引处的项。

GetMany(UInt32, UIElement[])

通过迭代器在一次传递中检索多个元素。

GetView()

获取集合中的不可变视图。

IndexOf(UIElement, UInt32)

检索指定项的索引。

InsertAt(UInt32, UIElement)

在指定的索引处插入指定的项。

Move(UInt32, UInt32)

将指定索引处的项移至集合中的新位置。

RemoveAt(UInt32)

删除指定索引处的项。

RemoveAtEnd()

删除集合中的最后一项。

ReplaceAll(UIElement[])

首先清除集合,然后将提供的数组作为新项插入。

SetAt(UInt32, UIElement)

将指定索引处的值设置为指定的 UIElement 值。

适用于

另请参阅