ItemCollection Class

Definition

Holds the list of items that represent the content of an ItemsControl.

Equivalent WinUI class: Microsoft.UI.Xaml.Controls.ItemCollection.

public ref class ItemCollection sealed : IIterable<Platform::Object ^>, IObservableVector<Platform::Object ^>, IVector<Platform::Object ^>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.WebHostHidden]
class ItemCollection final : IIterable<IInspectable>, IObservableVector<IInspectable>, IVector<IInspectable>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.WebHostHidden]
class ItemCollection final : IIterable<IInspectable>, IObservableVector<IInspectable>, IVector<IInspectable>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.WebHostHidden]
public sealed class ItemCollection : IEnumerable<object>, IList<object>, IObservableVector<object>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.WebHostHidden]
public sealed class ItemCollection : IEnumerable<object>, IList<object>, IObservableVector<object>
Public NotInheritable Class ItemCollection
Implements IEnumerable(Of Object), IList(Of Object), IObservableVector(Of Object)
<ItemsControl>
  oneOrMoreFrameworkElements
</ItemsControl>
Inheritance
ItemCollection
Attributes
Implements

Windows 10 requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Enumerating the collection in C# or Microsoft Visual Basic

An ItemCollection is enumerable, so you can use language-specific syntax such as foreach in C# to enumerate the items in the collection. The compiler does the type-casting for you and you won't need to cast to IEnumerable explicitly. If you do need to cast explicitly, for example if you want to call GetEnumerator, cast to IEnumerablewith an Object or FrameworkElement constraint.

Properties

Size

Gets the size (count) of the collection.

Equivalent WinUI property: Microsoft.UI.Xaml.Controls.ItemCollection.Size.

Methods

Append(Object)

Adds a new item to the collection.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.Append.

Clear()

Removes all items from the collection.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.Clear.

First()

Returns the iterator for iteration over the items in the collection.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.First.

GetAt(UInt32)

Returns the item located at the specified index.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.GetAt.

GetMany(UInt32, Object[])

Retrieves multiple elements in a single pass through the iterator.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.GetMany.

GetView()

Gets an immutable view into the collection.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.GetView.

IndexOf(Object, UInt32)

Retrieves the index of the specified item.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.IndexOf.

InsertAt(UInt32, Object)

Inserts the specified item at the specified index.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.InsertAt.

RemoveAt(UInt32)

Removes the item at the specified index.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.RemoveAt.

RemoveAtEnd()

Removes the last item in the collection.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.RemoveAtEnd.

ReplaceAll(Object[])

Initially clears the collection, then inserts the provided array as new items.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.ReplaceAll.

SetAt(UInt32, Object)

Sets the value at the specified index to the item value specified.

Equivalent WinUI method: Microsoft.UI.Xaml.Controls.ItemCollection.SetAt.

Events

VectorChanged

Occurs when the items list of the collection has changed, or the collection is reset.

Equivalent WinUI event: Microsoft.UI.Xaml.Controls.ItemCollection.VectorChanged.

Applies to

See also