RadItemsControl
Provides an abstract base class for RadControls that manage collections of RadItem objects, offering item selection, event handling, and collection management capabilities.
RadItemsControl serves as the foundation for controls that work with collections of interactive items such as list boxes, combo boxes, menus, toolbars, and tree views. It provides a unified programming model for item-based controls through the IItemsControl interface.
The class manages item selection state through ItemSelected and ItemDeselected events, coordinates with implementation objects for specialized behavior, and provides infrastructure for item collection management. It delegates specific functionality to implementation classes while maintaining a consistent public interface.
Derived classes include RadListControl, RadComboBox, RadMenu, and other controls that need to manage collections of selectable or interactive items with consistent behavior patterns and event handling throughout the Telerik WinControls framework.
Definition
Namespace:Telerik.WinControls
Assembly:Telerik.WinControls.dll
Syntax:
public abstract class RadItemsControl : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IItemsControlInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadItemsControl...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadItemsControl class.
public RadItemsControl()The constructor establishes the implementation pattern by creating an items control implementation object and wiring up the necessary event handlers for item selection and deselection events.
Properties
Gets a collection containing the items that are currently active.
public virtual RadItemOwnerCollection ActiveItems { get; }Implements:
public virtual bool HasKeyboardInput { get; }Gets the collection of items associated with the IItemsControl.
public abstract RadItemOwnerCollection Items { get; }Implements:
Gets or sets whether the RadItemsControl processes the keyboard.
[Browsable(false)]
public virtual bool ProcessKeyboard { get; set; }Implements:
Gets or sets whether the rollover items functionality of the RadItemsControl will be allowed.
[Browsable(false)]
public virtual bool RollOverItemSelection { get; set; }Implements:
Methods
public void CallOnItemDeselected(ItemSelectedEventArgs args)Defines whether the IItemsControl can execute navigation operation based on the keydata provided.
Defines whether the IItemsControl has an item that corresponds to the mnemonic passed in the parameter.
protected virtual void GetChildMnemonicList(ArrayList mnemonicList)Gets the first visible item from the collection. In a IItemsControl that is the first item that is visible on the control.
public virtual RadItem GetFirstVisibleItem()A reference to a RadItem instance that represents the first visible control.
Implements:
When overridden in a derived class, creates and returns the implementation object that provides the specific behavior for this items control.
protected virtual IItemsControl GetItemsControlImpl()An IItemsControl implementation that handles the specific behavior for this control type.
This factory method allows derived classes to specify their own implementation objects while maintaining the common RadItemsControl interface and event handling patterns. The default implementation returns a RadItemsControlImpl instance.
Gets the last visible item from the collection. In a IItemsControl that is the last item that is visible on the control.
public virtual RadItem GetLastVisibleItem()A reference to a RadItem instance that represents the last visible control.
Implements:
Gets an item from the collection that is next to a certain item.
Returns the selected item in the control.
public virtual RadItem GetSelectedItem()An reference to a RadItem instance which represents the currently selected item.
Implements:
protected virtual void OnItemDeselected(ItemSelectedEventArgs args)protected virtual void OnItemSelected(ItemSelectedEventArgs args)Selects the first visible item on the IItemsControl.
public virtual RadItem SelectFirstVisibleItem()A reference to a RadItem instance that represents the item selected.
Implements:
Selects an item in the control.
public virtual void SelectItem(RadItem item)A reference to a RadItem instance which represents the item which is to be selected.
Implements:
Selects the last visible item on the IItemsControl.
public virtual RadItem SelectLastVisibleItem()A reference to a RadItem instance that represents the item selected.
Implements:
Selects an item from the collection that is next to a certain item.
Events
Occurs when an item becomes deselected in the control.
public event ItemSelectedEventHandler ItemDeselectedImplements:
This event is raised whenever an item transitions from a selected to an unselected state, providing notification of deselection changes to enable cleanup operations and user interface state management.
Occurs when an item becomes selected in the control.
public event ItemSelectedEventHandler ItemSelectedImplements:
This event is raised whenever an item transitions from an unselected to a selected state, providing notification of selection changes to enable responsive user interface updates and business logic execution.