RadItemsPopupControl
Provides item selection, keyboard navigation, and drop-down lifecycle behavior for popup controls that host RadItem objects.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public abstract class RadItemsPopupControl : RadPopupControlBase, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IPopupControl, IItemsControl
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadPopupControlBaseRadItemsPopupControl...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes the popup with the element that owns and anchors it.
public RadItemsPopupControl(RadElement owner)
The element that owns the popup.
Properties
Gets the collection used by this popup's selection and navigation logic; it is the same collection as Items.
public RadItemOwnerCollection ActiveItems { get; }
Implements:
Gets a boolean value indicating whether the popup is visible.
public bool IsVisible { get; }
Gets menu items collection
[Browsable(true)]
public RadItemOwnerCollection Items { get; }
Implements:
Gets or sets whether this popup's item-control implementation processes keyboard input.
public bool ProcessKeyboard { get; set; }
Implements:
Gets or sets whether item navigation wraps between the last and first selectable items.
public bool RollOverItemSelection { get; set; }
Implements:
Methods
Resets the popup's size constraints to its current width and size.
protected void AutoUpdateBounds()
Forwards a deselection notification to the overridable OnItemDeselected(ItemSelectedEventArgs) hook.
public void CallOnItemDeselected(ItemSelectedEventArgs args)
The item-selection event data.
Determines whether this popup supports navigation with the supplied key. The shared implementation returns false; subclasses can provide navigation handling.
Determines whether this popup processes the supplied mnemonic character. The shared implementation returns false; subclasses can provide mnemonic handling.
Clears the active popup handle before delegating resource disposal to the base class.
Gets the next visible, selectable item relative to item.
Navigation can wrap around when RollOverItemSelection is enabled.
Raises DropDownClosed after the popup closes.
protected virtual void OnDropDownClosed(RadPopupClosedEventArgs args)
Information about the popup-closing operation.
Raises DropDownClosing before the popup closes.
protected virtual void OnDropDownClosing(RadPopupClosingEventArgs args)
Information about the popup-closing operation.
Raises DropDownOpened after the popup opens.
protected virtual void OnDropDownOpened()
Raises DropDownOpening and allows handlers to cancel the opening operation.
protected virtual void OnDropDownOpening(CancelEventArgs args)
The event data whose Cancel value can prevent opening.
Runs after the ItemDeselected event is raised, allowing subclasses to respond to item deselection.
protected virtual void OnItemDeselected(ItemSelectedEventArgs args)
The item-selection event data.
Runs after the ItemSelected event is raised, allowing subclasses to respond to item selection.
protected virtual void OnItemSelected(ItemSelectedEventArgs args)
The item-selection event data.
Selects an item, raising ItemDeselected for a different previously selected item before ItemSelected for the new item.
Selects the next visible, selectable item relative to item.
Events
Occurs after the popup has closed.
public event RadPopupClosedEventHandler DropDownClosed
Occurs before the popup closes.
public event RadPopupClosingEventHandler DropDownClosing
Occurs after the popup has opened.
public event EventHandler DropDownOpened
Occurs before the popup opens; the event handler can cancel the opening operation.
public event CancelEventHandler DropDownOpening
Occurs when the popup's item-selection logic deselects an item.
public event ItemSelectedEventHandler ItemDeselected
Implements:
Occurs when the popup's item-selection logic selects an item.
public event ItemSelectedEventHandler ItemSelected
Implements: