Class RadItemVirtualizationCollection
A specialized collection for RadItem objects that supports virtualization for performance optimization in large datasets.
Inheritance
Inherited Members
Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll
Syntax
public class RadItemVirtualizationCollection : RadItemCollection, IList, ICollection, IEnumerable<RadItem>, IEnumerable, IVirtualizationCollection
Remarks
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.
Constructors
RadItemVirtualizationCollection()
Initializes a new instance of the RadItemVirtualizationCollection class.
Declaration
public RadItemVirtualizationCollection()
RadItemVirtualizationCollection(IVirtualViewport)
Initializes a new instance of the RadItemVirtualizationCollection class with the specified viewport.
Declaration
public RadItemVirtualizationCollection(IVirtualViewport ownerViewport)
Parameters
IVirtualViewport
ownerViewport
The virtual viewport that will manage virtualization for this collection. |
Properties
OwnerViewport
Gets or sets the virtual viewport that manages the virtualization behavior for this collection.
Declaration
public IVirtualViewport OwnerViewport { get; set; }
Property Value
IVirtualViewport
The IVirtualViewport instance that handles virtualization operations. |
Remarks
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(Int32)
Gets the virtual data at the specified index.
Declaration
public object GetVirtualData(int index)
Parameters
System.Int32
index
The zero-based index of the data to retrieve. |
Returns
System.Object
The data at the specified index, or null if the index is out of range. |
Implements
IndexOf(Object)
Determines the index of a specific data item in the collection.
Declaration
public int IndexOf(object data)
Parameters
System.Object
data
The data item to locate in the collection. |
Returns
System.Int32
The zero-based index of the item if found; otherwise, -1. |
Implements
OnClear()
OnClearComplete()
OnInsertComplete(Int32, Object)
Declaration
protected override void OnInsertComplete(int index, object value)
Parameters
System.Int32
index
|
System.Object
value
|
Overrides
OnRemoveComplete(Int32, Object)
Declaration
protected override void OnRemoveComplete(int index, object value)
Parameters
System.Int32
index
|
System.Object
value
|
Overrides
OnSetComplete(Int32, Object, Object)
Declaration
protected override void OnSetComplete(int index, object oldValue, object newValue)
Parameters
System.Int32
index
|
System.Object
oldValue
|
System.Object
newValue
|