Class RadDropDownMenu

Represents a drop down menu used in radComboBox and radMenu.

Inheritance
System.Object
RadControl
RadPopupControlBase
RadItemsPopupControl
RadDropDownMenu
RadContextMenuDropDown
RadDropDownButtonPopup
RadGalleryDropDown
SchedulerInplaceDropDownMenu
VirtualGridContextMenu
SpreadsheetFilteringDropDownMenu
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[RadToolboxItem(false)]
public class RadDropDownMenu : RadItemsPopupControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, IPopupControl, IItemsControl

Constructors

RadDropDownMenu()

Initializes a new instance of the RadDropDownMenu class

Declaration
public RadDropDownMenu()

RadDropDownMenu(RadElement)

Creates an instance of the RadDropDownMenu class.

Declaration
public RadDropDownMenu(RadElement ownerElement)
Parameters
RadElement ownerElement

An instance of the RadElement class that represents the owner of this drop down menu

Properties

CausesValidation

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

ClickedItem

Gets the item that has been clicked. This property is valid when the drop-down is closed by an item click.

Declaration
public RadItem ClickedItem { get; }
Property Value
RadItem

HeaderImage

Gets or sets menu header column image

Declaration
public Image HeaderImage { get; set; }
Property Value
System.Drawing.Image

HeaderText

Gets or sets menu header column text

Declaration
public string HeaderText { get; set; }
Property Value
System.String

IsTwoColumnMenu

Indicates whether the DropDown contains one or two cloumns of items.

Declaration
public virtual bool IsTwoColumnMenu { get; set; }
Property Value
System.Boolean

PopupElement

Gets or sets the popup element.

Declaration
public RadElement PopupElement { get; set; }
Property Value
RadElement

RootTreeHandler

Declaration
public IComponentTreeHandler RootTreeHandler { get; }
Property Value
IComponentTreeHandler

ThemeClassName

Declaration
public override string ThemeClassName { get; set; }
Property Value
System.String

Overrides

Methods

CanClosePopup(RadPopupCloseReason)

Declaration
public override bool CanClosePopup(RadPopupCloseReason reason)
Parameters
RadPopupCloseReason reason

Returns
System.Boolean

Overrides

CanNavigate(Keys)

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

Returns
System.Boolean

Overrides

CanProcessItem(RadMenuItemBase)

Declaration
protected virtual bool CanProcessItem(RadMenuItemBase menuItem)
Parameters
RadMenuItemBase menuItem

Returns
System.Boolean

CanProcessMnemonic(Char)

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

Returns
System.Boolean

Overrides

CheckCanNavigate(Keys)

Declaration
protected virtual bool CheckCanNavigate(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

Returns
System.Boolean

CheckCanProcessMnemonic(IItemsControl, Char)

Declaration
protected virtual bool CheckCanProcessMnemonic(IItemsControl itemsControl, char keyData)
Parameters
IItemsControl itemsControl

System.Char keyData

Returns
System.Boolean

ControlDefinesThemeForElement(RadElement)

Declaration
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters
RadElement element

Returns
System.Boolean

Overrides

CreateAccessibilityInstance()

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
System.Windows.Forms.AccessibleObject

CreatePopupElement()

Declaration
protected virtual RadElement CreatePopupElement()
Returns
RadElement

Dispose(Boolean)

Declaration
protected override void Dispose(bool disposing)
Parameters
System.Boolean disposing

Overrides

DoOnItemClicked(RadMenuItemBase, MouseEventArgs)

Declaration
protected virtual void DoOnItemClicked(RadMenuItemBase menuItem, MouseEventArgs e)
Parameters
RadMenuItemBase menuItem

System.Windows.Forms.MouseEventArgs e

EnsureItemEnabled(RadItem, Boolean)

Selects next enabled item.

Declaration
protected virtual void EnsureItemEnabled(RadItem item, bool isUp)
Parameters
RadItem item

The currently selected item.
System.Boolean isUp

Direction.

GetMenuItemAtPoint(Point)

Declaration
protected RadMenuItemBase GetMenuItemAtPoint(Point location)
Parameters
System.Drawing.Point location

Returns
RadMenuItemBase

GetOwnerScreenLocation()

Declaration
protected virtual Point GetOwnerScreenLocation()
Returns
System.Drawing.Point

GetOwnerSize()

Declaration
protected virtual Size GetOwnerSize()
Returns
System.Drawing.Size

InitializeChildren()

Declaration
protected virtual void InitializeChildren()

OnDropDownClosed(RadPopupClosedEventArgs)

Declaration
protected override void OnDropDownClosed(RadPopupClosedEventArgs args)
Parameters
RadPopupClosedEventArgs args

Overrides

OnDropDownLocationNeeded(Point)

Declaration
protected virtual Point OnDropDownLocationNeeded(Point point)
Parameters
System.Drawing.Point point

Returns
System.Drawing.Point

OnItemDeselected(ItemSelectedEventArgs)

Declaration
protected override void OnItemDeselected(ItemSelectedEventArgs args)
Parameters
ItemSelectedEventArgs args

Overrides

OnItemsChanged(RadItemCollection, RadItem, ItemsChangeOperation)

Declaration
protected virtual void OnItemsChanged(RadItemCollection changed, RadItem target, ItemsChangeOperation operation)
Parameters
RadItemCollection changed

RadItem target

ItemsChangeOperation operation

OnItemSelected(ItemSelectedEventArgs)

Declaration
protected override void OnItemSelected(ItemSelectedEventArgs args)
Parameters
ItemSelectedEventArgs args

Overrides

OnKeyDown(Keys)

Declaration
public override bool OnKeyDown(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

Returns
System.Boolean

Overrides

OnLoad(Size)

Declaration
protected override void OnLoad(Size desiredSize)
Parameters
System.Drawing.Size desiredSize

Overrides

OnMouseClick(MouseEventArgs)

Declaration
protected override void OnMouseClick(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

OnMouseDown(MouseEventArgs)

Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

Overrides

OnMouseMove(MouseEventArgs)

Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

Overrides

OnMouseWheel(Control, Int32)

Declaration
public override bool OnMouseWheel(Control target, int delta)
Parameters
System.Windows.Forms.Control target

System.Int32 delta

Returns
System.Boolean

Overrides

OnScreenTipNeeded(Object, ScreenTipNeededEventArgs)

Declaration
protected override void OnScreenTipNeeded(object sender, ScreenTipNeededEventArgs e)
Parameters
System.Object sender

ScreenTipNeededEventArgs e

Overrides

OnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)

Declaration
protected override void OnToolTipTextNeeded(object sender, ToolTipTextNeededEventArgs e)
Parameters
System.Object sender

ToolTipTextNeededEventArgs e

Overrides

PerformItemClick(RadMenuItemBase)

Declaration
protected void PerformItemClick(RadMenuItemBase menuItem)
Parameters
RadMenuItemBase menuItem

PerformMenuItemClick(RadMenuItemBase)

Declaration
protected virtual void PerformMenuItemClick(RadMenuItemBase menuItem)
Parameters
RadMenuItemBase menuItem

ProcessDialogChar(Char)

Declaration
protected override bool ProcessDialogChar(char charCode)
Parameters
System.Char charCode

Returns
System.Boolean

ProcessLeftRightNavigationKey(Boolean)

Declaration
protected virtual bool ProcessLeftRightNavigationKey(bool isLeft)
Parameters
System.Boolean isLeft

Returns
System.Boolean

ProcessMnemonic(Keys)

Declaration
protected virtual bool ProcessMnemonic(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

Returns
System.Boolean

ProcessUpDownNavigationKey(Boolean)

Declaration
protected virtual bool ProcessUpDownNavigationKey(bool isUp)
Parameters
System.Boolean isUp

Returns
System.Boolean

SetVisibleCore(Boolean)

Declaration
protected override void SetVisibleCore(bool value)
Parameters
System.Boolean value

Show()

Displays the RadDropDownMenu in its default position.

Declaration
public void Show()

Show(Point)

Displays the RadDropDownMenu relative to the specified screen location.

Declaration
public void Show(Point point)
Parameters
System.Drawing.Point point

The horizontal and vertical location of the screen's upper-left corner, in pixels.

Show(Point, RadDirection)

Positions the ToolStripDropDown relative to the specified screen location and with the specified direction.

Declaration
public void Show(Point point, RadDirection popupDirection)
Parameters
System.Drawing.Point point

The horizontal and vertical location of the screen's upper-left corner, in pixels.
RadDirection popupDirection

One of the RadDirection values.

Show(Int32, Int32)

Displays the RadDropDownMenu relative to the specified screen location.

Declaration
public void Show(int x, int y)
Parameters
System.Int32 x

The horizontal screen coordinate, in pixels.
System.Int32 y

The vertical screen coordinate, in pixels.

Show(Control, Point)

Positions the RadDropDownMenu relative to the specified control location.

Declaration
public void Show(Control control, Point point)
Parameters
System.Windows.Forms.Control control

The control that is the reference point for the RadDropDownMenu position.
System.Drawing.Point point

The horizontal and vertical location of the reference control's upper-left corner, in pixels.

Show(Control, Point, RadDirection)

Positions the RadDropDownMenu relative to the specified control location and with the specified direction.

Declaration
public void Show(Control control, Point point, RadDirection popupDirection)
Parameters
System.Windows.Forms.Control control

The control that is the reference point for the RadDropDownMenu position.
System.Drawing.Point point

The horizontal and vertical location of the reference control's upper-left corner, in pixels.
RadDirection popupDirection

One of the RadDirection values.

Show(Control, Int32, Int32)

Positions the RadDropDownMenu relative to the specified control location.

Declaration
public void Show(Control control, int x, int y)
Parameters
System.Windows.Forms.Control control

The control that is the reference point for the RadDropDownMenu position.
System.Int32 x

The horizontal coordinate relative to the control, in pixels.
System.Int32 y

The vertical coordinate relative to the control, in pixels.

Show(RadItem, Point)

Positions the RadDropDownMenu relative to the specified RadItem location.

Declaration
public void Show(RadItem item, Point point)
Parameters
RadItem item

The RadItem that is the reference point for the RadDropDownMenu position.
System.Drawing.Point point

The horizontal and vertical location of the RadItem's upper-left corner, in pixels.

Show(RadItem, Point, RadDirection)

Positions the RadDropDownMenu relative to the specified RadItem location and with the specified direction.

Declaration
public void Show(RadItem item, Point point, RadDirection popupDirection)
Parameters
RadItem item

The RadItem that is the reference point for the RadDropDownMenu position.
System.Drawing.Point point

The horizontal and vertical location of the RadItem's upper-left corner, in pixels.
RadDirection popupDirection

One of the RadDirection values.

Show(RadItem, Int32, Int32)

Positions the RadDropDownMenu relative to the specified RadItem location.

Declaration
public void Show(RadItem item, int x, int y)
Parameters
RadItem item

The RadItem that is the reference point for the RadDropDownMenu position.
System.Int32 x

The horizontal coordinate relative to the control, in pixels.
System.Int32 y

The vertical coordinate relative to the control, in pixels.

Show(RadItem, Int32, RadDirection)

Positions the RadDropDownMenu relative to the specified RadItem location and with specified direction and offset according to the owner.

Declaration
public void Show(RadItem item, int ownerOffset, RadDirection popupDirection)
Parameters
RadItem item

The RadItem that is the reference point for the RadDropDownMenu position.
System.Int32 ownerOffset

Specifies the offset from the owner in pixels.
RadDirection popupDirection

One of the RadDirection values.

ShowCore(Point, Int32, RadDirection)

Declaration
protected virtual void ShowCore(Point point, int ownerOffset, RadDirection popupDirection)
Parameters
System.Drawing.Point point

System.Int32 ownerOffset

RadDirection popupDirection

Extension Methods