Interface IItemsControl

An interface which provides methods for handling a collection of RadItems. This interface is used throughout controls which represent a list of items.

Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll

Syntax

public interface IItemsControl

Properties

ActiveItems

Gets a collection containing the items that are currently active.

Declaration
RadItemOwnerCollection ActiveItems { get; }
Property Value
RadItemOwnerCollection

Items

Gets the collection of items associated with the IItemsControl.

Declaration
RadItemOwnerCollection Items { get; }
Property Value
RadItemOwnerCollection

ProcessKeyboard

Gets or sets a boolean value that determines whether keyboard input will be processed by the IItemsControl.

Declaration
bool ProcessKeyboard { get; set; }
Property Value
System.Boolean

RollOverItemSelection

Gets or sets a boolean value that determines whether the rollover items functionality will be allowed.

Declaration
bool RollOverItemSelection { get; set; }
Property Value
System.Boolean

Methods

CanNavigate(Keys)

Defines whether the IItemsControl can execute navigation operation based on the keydata provided.

Declaration
bool CanNavigate(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

An instance of the System.Windows.Forms.Keys struct that defines the key command issued.
Returns
System.Boolean

True if navigation possible, otherwise false.

CanProcessMnemonic(Char)

Defines whether the IItemsControl has an item that corresponds to the mnemonic passed in the parameter.

Declaration
bool CanProcessMnemonic(char keyData)
Parameters
System.Char keyData

A character that defines the mnemonic command issued.
Returns
System.Boolean

True if mnemonic can be processed, otherwise false.

GetFirstVisibleItem()

Gets the first visible item from the collection. In a IItemsControl that is the first item that is visible on the control.

Declaration
RadItem GetFirstVisibleItem()
Returns
RadItem

A reference to a RadItem instance that represents the first visible control.

GetLastVisibleItem()

Gets the last visible item from the collection. In a IItemsControl that is the last item that is visible on the control.

Declaration
RadItem GetLastVisibleItem()
Returns
RadItem

A reference to a RadItem instance that represents the last visible control.

GetNextItem(RadItem, Boolean)

Gets an item from the collection that is next to a certain item.

Declaration
RadItem GetNextItem(RadItem item, bool forward)
Parameters
RadItem item

The item which neighbour to return.
System.Boolean forward

The direction in which to look for the neighbour.
Returns
RadItem

A reference to a RadItem instance which represents the neighbour item.

GetSelectedItem()

Returns the selected item in the control.

Declaration
RadItem GetSelectedItem()
Returns
RadItem

An reference to a RadItem instance which represents the currently selected item.

SelectFirstVisibleItem()

Selects the first visible item on the IItemsControl.

Declaration
RadItem SelectFirstVisibleItem()
Returns
RadItem

A reference to a RadItem instance that represents the item selected.

SelectItem(RadItem)

Selects an item in the control.

Declaration
void SelectItem(RadItem item)
Parameters
RadItem item

A reference to a RadItem instance which represents the item which is to be selected.

SelectLastVisibleItem()

Selects the last visible item on the IItemsControl.

Declaration
RadItem SelectLastVisibleItem()
Returns
RadItem

A reference to a RadItem instance that represents the item selected.

SelectNextItem(RadItem, Boolean)

Selects an item from the collection that is next to a certain item.

Declaration
RadItem SelectNextItem(RadItem item, bool forward)
Parameters
RadItem item

The item which neighbour to return.
System.Boolean forward

The direction in which to look for the neighbour.
Returns
RadItem

A reference to a RadItem instance which represents the neighbour item.

Events

ItemDeselected

Fires when an item has been deselected.

Declaration
event ItemSelectedEventHandler ItemDeselected
Event Type
ItemSelectedEventHandler

ItemSelected

Fires when an item has been selected.

Declaration
event ItemSelectedEventHandler ItemSelected
Event Type
ItemSelectedEventHandler

Extension Methods