ClassRadItemsControlImpl
Represents an encapsulated implementation of the IItemsControl interface. Provides core functionality for item selection, navigation, and keyboard processing in controls that manage collections of RadItem objects.
Definition
Namespace:Telerik.WinControls
Assembly:Telerik.WinControls.dll
Syntax:
public class RadItemsControlImpl : IItemsControlInheritance: objectRadItemsControlImpl
Implements:
Constructors
RadItemsControlImpl(RadItemOwnerCollection)
Initializes a new instance of the RadItemsControlImpl class.
Declaration
public RadItemsControlImpl(RadItemOwnerCollection items)Parameters
items
The collection of items to manage.
Properties
ActiveItems
Gets the collection of active items. This is an alias for the Items property.
Declaration
public RadItemOwnerCollection ActiveItems { get; }Property Value
The collection of active RadItem objects.
Implements
Items
Gets the collection of items managed by this control implementation.
Declaration
public RadItemOwnerCollection Items { get; }Property Value
The RadItemOwnerCollection containing all managed items.
Implements
ProcessKeyboard
Gets or sets a value indicating whether the control should process keyboard input.
Declaration
public bool ProcessKeyboard { get; set; }Property Value
true if keyboard processing is enabled; otherwise, false.
The default value is false.
Implements
RollOverItemSelection
Gets or sets a value indicating whether item selection should roll over from the last item to the first item (and vice versa) during navigation.
Declaration
public bool RollOverItemSelection { get; set; }Property Value
true if rollover selection is enabled; otherwise, false.
The default value is false.
Implements
Methods
CanNavigate(Keys)
Determines whether the control can navigate using the specified key.
CanProcessMnemonic(char)
Determines whether the control can process the specified mnemonic character.
GetFirstVisibleItem()
Gets the first visible and selectable item in the collection.
GetLastVisibleItem()
Gets the last visible and selectable item in the collection.
GetNextItem(RadItem, bool)
Gets the next selectable item in the collection relative to the specified item.
Declaration
public RadItem GetNextItem(RadItem item, bool forward)Parameters
item
The reference item to navigate from, or null to get the first item.
forward
True to navigate forward, false to navigate backward.
Returns
The next selectable item, or null if no suitable item is found.
Implements
Remarks
If RollOverItemSelection is enabled, navigation will wrap around to the beginning/end when reaching the last/first item respectively.
GetSelectedItem()
Gets the currently selected item.
SelectFirstVisibleItem()
Selects the first visible and selectable item in the collection.
SelectItem(RadItem)
Selects the specified item and raises appropriate selection events.
Declaration
public void SelectItem(RadItem item)Parameters
item
The item to select.
Implements
Remarks
If a different item was previously selected, the ItemDeselected event is raised for the old item before selecting the new item and raising the ItemSelected event.
SelectLastVisibleItem()
Selects the last visible and selectable item in the collection.
SelectNextItem(RadItem, bool)
Selects the next item in the specified direction relative to the current item.
Declaration
public RadItem SelectNextItem(RadItem item, bool forward)Parameters
item
The current item to navigate from.
forward
True to select the next item, false to select the previous item.
Returns
The newly selected item, or null if no suitable item was found.
Implements
Events
ItemDeselected
Occurs when an item is deselected.
Declaration
public event ItemSelectedEventHandler ItemDeselectedEvent Value
Implements
ItemSelected
Occurs when an item is selected.
Declaration
public event ItemSelectedEventHandler ItemSelectedEvent Value
Implements