New to Telerik UI for WinForms? Start a free 30-day trial

RadItemVirtualizationCollection

Class

A specialized collection for RadItem objects that supports virtualization for performance optimization in large datasets.

This collection integrates with IVirtualViewport to provide virtualization capabilities, allowing UI controls to efficiently handle large numbers of items by only creating visual elements for items currently in view. The collection automatically notifies the viewport about data changes to maintain virtualization state.

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

public class RadItemVirtualizationCollection : RadItemCollection, IList, ICollection, IEnumerable, IVirtualizationCollection

Inheritance: objectCollectionBaseRadItemCollectionRadItemVirtualizationCollection

Implements: ICollectionIEnumerableIListIVirtualizationCollection

Inherited Members RadItemCollection.OnItemsChanged(RadItem, ItemsChangeOperation)RadItemCollection.OnValidate(object)RadItemCollection.SuspendNotifications()RadItemCollection.ResumeNotifications()RadItemCollection.GetEnumerator()RadItemCollection.OnRemove(int, object)RadItemCollection.OnSet(int, object, object)RadItemCollection.Add(RadItem)RadItemCollection.AddRange(params RadItem[])RadItemCollection.AddRange(RadItemCollection)RadItemCollection.Insert(int, RadItem)RadItemCollection.Remove(RadItem)RadItemCollection.Sort()RadItemCollection.Sort(IComparer)RadItemCollection.Sort(int, int, IComparer)RadItemCollection.Contains(RadItem)RadItemCollection.IndexOf(RadItem)RadItemCollection.CopyTo(RadItem[], int)RadItemCollection.ToArray()RadItemCollection.ItemTypesRadItemCollection.ExcludedTypesRadItemCollection.SealedTypesRadItemCollection.DefaultTypeRadItemCollection.this[int]RadItemCollection.FirstRadItemCollection.LastRadItemCollection.this[string]RadItemCollection.ItemsChangedCollectionBase.Clear()CollectionBase.RemoveAt(int)CollectionBase.OnInsert(int, object)CollectionBase.InnerListCollectionBase.ListCollectionBase.CapacityCollectionBase.Count...

Constructors

RadItemVirtualizationCollection()

Initializes a new instance of the RadItemVirtualizationCollection class.

public RadItemVirtualizationCollection()

RadItemVirtualizationCollection(IVirtualViewport)

Initializes a new instance of the RadItemVirtualizationCollection class with the specified viewport.

public RadItemVirtualizationCollection(IVirtualViewport ownerViewport)

Parameters:ownerViewportIVirtualViewport

The virtual viewport that will manage virtualization for this collection.

Properties

OwnerViewport

IVirtualViewport

Gets or sets the virtual viewport that manages the virtualization behavior for this collection.

[Browsable(false)]
public IVirtualViewport OwnerViewport { get; set; }

Property Value:

The IVirtualViewport instance that handles virtualization operations.

The viewport is responsible for determining which items are visible and need to be realized, and manages the virtualization lifecycle for performance optimization.

Methods

GetVirtualData(int)

Gets the virtual data at the specified index.

public object GetVirtualData(int index)

Parameters:indexint

The zero-based index of the data to retrieve.

Returns:

object

The data at the specified index, or null if the index is out of range.

Implements: IVirtualizationCollection.GetVirtualData(int)

IndexOf(object)

Determines the index of a specific data item in the collection.

public int IndexOf(object data)

Parameters:dataobject

The data item to locate in the collection.

Returns:

int

The zero-based index of the item if found; otherwise, -1.

Implements: IVirtualizationCollection.IndexOf(object)

OnClear()

protected override void OnClear()

Overrides: RadItemCollection.OnClear()

OnClearComplete()

protected override void OnClearComplete()

Overrides: RadItemCollection.OnClearComplete()

OnInsertComplete(int, object)

protected override void OnInsertComplete(int index, object value)

Parameters:indexintvalueobject

Overrides: RadItemCollection.OnInsertComplete(int, object)

OnRemoveComplete(int, object)

protected override void OnRemoveComplete(int index, object value)

Parameters:indexintvalueobject

Overrides: RadItemCollection.OnRemoveComplete(int, object)

OnSetComplete(int, object, object)

protected override void OnSetComplete(int index, object oldValue, object newValue)

Parameters:indexintoldValueobjectnewValueobject

Overrides: RadItemCollection.OnSetComplete(int, object, object)

OnSort()

protected override void OnSort()

Overrides: RadItemCollection.OnSort()

OnSortComplete()

protected override void OnSortComplete()

Overrides: RadItemCollection.OnSortComplete()