New to Telerik UI for WinFormsStart a free 30-day trial

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:

C#
public class RadItemsControlImpl : IItemsControl

Inheritance: objectRadItemsControlImpl

Implements: IItemsControl

Constructors

Initializes a new instance of the RadItemsControlImpl class.

C#
public RadItemsControlImpl(RadItemOwnerCollection items)
Parameters:itemsRadItemOwnerCollection

The collection of items to manage.

Properties

Gets the collection of active items. This is an alias for the Items property.

C#
public RadItemOwnerCollection ActiveItems { get; }
Property Value:

The collection of active RadItem objects.

Implements: IItemsControl.ActiveItems

Gets the collection of items managed by this control implementation.

C#
public RadItemOwnerCollection Items { get; }
Property Value:

The RadItemOwnerCollection containing all managed items.

Implements: IItemsControl.Items

Gets or sets a value indicating whether the control should process keyboard input.

C#
public bool ProcessKeyboard { get; set; }
Property Value:

true if keyboard processing is enabled; otherwise, false. The default value is false.

Implements: IItemsControl.ProcessKeyboard

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.

C#
public bool RollOverItemSelection { get; set; }
Property Value:

true if rollover selection is enabled; otherwise, false. The default value is false.

Implements: IItemsControl.RollOverItemSelection

Methods

Determines whether the control can navigate using the specified key.

C#
public bool CanNavigate(Keys keyData)
Parameters:keyDataKeys

The key to check for navigation capability.

Returns:

bool

Always returns false in the current implementation.

Implements: IItemsControl.CanNavigate(Keys)

Determines whether the control can process the specified mnemonic character.

C#
public bool CanProcessMnemonic(char keyData)
Parameters:keyDatachar

The mnemonic character to check.

Returns:

bool

Always returns false in the current implementation.

Implements: IItemsControl.CanProcessMnemonic(char)

Gets the first visible and selectable item in the collection.

C#
public RadItem GetFirstVisibleItem()
Returns:

RadItem

The first visible and selectable RadItem, or null if none exists.

Implements: IItemsControl.GetFirstVisibleItem()

Gets the last visible and selectable item in the collection.

C#
public RadItem GetLastVisibleItem()
Returns:

RadItem

The last visible and selectable RadItem, or null if none exists.

Implements: IItemsControl.GetLastVisibleItem()

Gets the next selectable item in the collection relative to the specified item.

C#
public RadItem GetNextItem(RadItem item, bool forward)
Parameters:itemRadItem

The reference item to navigate from, or null to get the first item.

forwardbool

True to navigate forward, false to navigate backward.

Returns:

RadItem

The next selectable item, or null if no suitable item is found.

Implements: IItemsControl.GetNextItem(RadItem, bool)

Remarks:

If RollOverItemSelection is enabled, navigation will wrap around to the beginning/end when reaching the last/first item respectively.

Gets the currently selected item.

C#
public RadItem GetSelectedItem()
Returns:

RadItem

The currently selected RadItem, or null if no item is selected.

Implements: IItemsControl.GetSelectedItem()

Selects the first visible and selectable item in the collection.

C#
public RadItem SelectFirstVisibleItem()
Returns:

RadItem

The selected RadItem, or null if no suitable item exists.

Implements: IItemsControl.SelectFirstVisibleItem()

Selects the specified item and raises appropriate selection events.

C#
public void SelectItem(RadItem item)
Parameters:itemRadItem

The item to select.

Implements: IItemsControl.SelectItem(RadItem)

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.

Selects the last visible and selectable item in the collection.

C#
public RadItem SelectLastVisibleItem()
Returns:

RadItem

The selected RadItem, or null if no suitable item exists.

Implements: IItemsControl.SelectLastVisibleItem()

Selects the next item in the specified direction relative to the current item.

C#
public RadItem SelectNextItem(RadItem item, bool forward)
Parameters:itemRadItem

The current item to navigate from.

forwardbool

True to select the next item, false to select the previous item.

Returns:

RadItem

The newly selected item, or null if no suitable item was found.

Implements: IItemsControl.SelectNextItem(RadItem, bool)

Events

Occurs when an item is deselected.

C#
public event ItemSelectedEventHandler ItemDeselected

Implements: IItemsControl.ItemDeselected

Occurs when an item is selected.

C#
public event ItemSelectedEventHandler ItemSelected

Implements: IItemsControl.ItemSelected