RadDropDownMenu
Represents a drop-down menu control that can be used as a popup menu for various UI elements.
Provides functionality for displaying menu items with support for hierarchical menus, animations, and keyboard navigation.
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll
Syntax:
[ RadToolboxItem ( false ) ]
public class RadDropDownMenu : RadItemsPopupControl , IDropTarget , ISynchronizeInvoke , IWin32Window , IBindableComponent , IComponent , IDisposable , INotifyPropertyChanged , ISupportInitializeNotification , ISupportInitialize , IComponentTreeHandler , ILayoutHandler , IAnalyticsProvider , IPopupControl , IItemsControl
Inheritance:
object MarshalByRefObject Component Control ScrollableControl RadControl RadPopupControlBase RadItemsPopupControl RadDropDownMenu
Derived Classes:
RadContextMenuDropDown RadDropDownButtonPopup RadGalleryDropDown SchedulerInplaceDropDownMenu VirtualGridContextMenu SpreadsheetFilteringDropDownMenu Show more
Implements:
IAnalyticsProvider IBindableComponent IComponent IComponentTreeHandler IDisposable IDropTarget IItemsControl ILayoutHandler INotifyPropertyChanged IPopupControl ISupportInitialize ISupportInitializeNotification ISynchronizeInvoke IWin32Window Show more
Inherited Members
RadItemsPopupControl.CallOnItemDeselected(ItemSelectedEventArgs) RadItemsPopupControl.OnDropDownOpening(CancelEventArgs) RadItemsPopupControl.OnDropDownClosing(RadPopupClosingEventArgs) RadItemsPopupControl.OnDropDownOpened() RadItemsPopupControl.AutoUpdateBounds() RadItemsPopupControl.GetSelectedItem() RadItemsPopupControl.SelectItem(RadItem) RadItemsPopupControl.GetNextItem(RadItem, bool) RadItemsPopupControl.SelectNextItem(RadItem, bool) RadItemsPopupControl.GetFirstVisibleItem() RadItemsPopupControl.GetLastVisibleItem() RadItemsPopupControl.SelectFirstVisibleItem() RadItemsPopupControl.SelectLastVisibleItem() RadItemsPopupControl.IsVisible RadItemsPopupControl.Items RadItemsPopupControl.Minimum RadItemsPopupControl.Maximum RadItemsPopupControl.ActiveItems RadItemsPopupControl.RollOverItemSelection RadItemsPopupControl.ProcessKeyboard RadItemsPopupControl.ItemSelected RadItemsPopupControl.ItemDeselected RadItemsPopupControl.DropDownOpening RadItemsPopupControl.DropDownClosing RadItemsPopupControl.DropDownOpened RadItemsPopupControl.DropDownClosed RadPopupControlBase.lastAlignmentRectangle RadPopupControlBase.dpiScaleFactor RadPopupControlBase.AnimationProperties RadPopupControlBase.GetMonitorDpiScaleFactor(Control) RadPopupControlBase.Show(Control) RadPopupControlBase.Hide() RadPopupControlBase.ProcessFocusRequested(RadElement) RadPopupControlBase.WndProc(ref Message) RadPopupControlBase.OnPopupOpened() RadPopupControlBase.OnPopupOpening(CancelEventArgs) RadPopupControlBase.OnPopupClosed(RadPopupClosedEventArgs) RadPopupControlBase.OnPopupClosing(RadPopupClosingEventArgs) RadPopupControlBase.InitializeDropDownAnimation(Point) RadPopupControlBase.GetBackupSize() RadPopupControlBase.UpdateAeroEffectState() RadPopupControlBase.UpdateLocation(Rectangle) RadPopupControlBase.UpdateLocation() RadPopupControlBase.GetCorrectedLocation(Rectangle) RadPopupControlBase.GetCorrectedLocation(Screen, Rectangle) RadPopupControlBase.GetCorrectedLocation(Screen, Rectangle, Size) RadPopupControlBase.ApplySizingConstraints(Size, Screen) RadPopupControlBase.GetCurrentScreen(Rectangle) RadPopupControlBase.GetCurrentScreen() RadPopupControlBase.GetAvailableBoundsFromScreen(Screen) RadPopupControlBase.GetCorrectedHorizontalLocation(Screen, Rectangle, Point) RadPopupControlBase.GetCorrectedHorizontalLocation(Screen, Rectangle, Point, Size) RadPopupControlBase.GetCorrectedVerticalLocation(Screen, Rectangle, Point) RadPopupControlBase.GetCorrectedVerticalLocation(Screen, Rectangle, Point, Size) RadPopupControlBase.GetHorizontalPopupLocation(Rectangle) RadPopupControlBase.GetVerticalPopupLocation(Rectangle) RadPopupControlBase.AnimationStarting() RadPopupControlBase.OnAlternativeXLocationNeeded(Rectangle, Point, Rectangle) RadPopupControlBase.CheckMakeLastLocationCorrection(Rectangle, Point, Rectangle) RadPopupControlBase.CheckMakeLastLocationCorrection(Rectangle, Point, Rectangle, Size) RadPopupControlBase.OnAlternativeYLocationNeeded(Rectangle, Point, Rectangle) RadPopupControlBase.ShowPopupCore(Size, Point) RadPopupControlBase.ShowPopup(Rectangle) RadPopupControlBase.ClosePopup(PopupCloseInfo) RadPopupControlBase.OnPopupClosing(PopupCloseInfo) RadPopupControlBase.OnPopupClosed(PopupCloseInfo) RadPopupControlBase.ClosePopup(RadPopupCloseReason) RadPopupControlBase.CallMouseWheel(MouseEventArgs) RadPopupControlBase.OnAnimationFinished(AnimationEventArgs) RadPopupControlBase.OnAnimating(AnimationEventArgs) RadPopupControlBase.ShouldRestoreAutoSize RadPopupControlBase.DropDownAnimationDirection RadPopupControlBase.EasingType RadPopupControlBase.AnimationFrames RadPopupControlBase.AnimationEnabled RadPopupControlBase.AnimationType RadPopupControlBase.NonAnimatedSize RadPopupControlBase.FadeAnimationFrames RadPopupControlBase.FadeAnimationSpeed RadPopupControlBase.Opacity RadPopupControlBase.DropShadow RadPopupControlBase.EnableAeroEffects RadPopupControlBase.FadeAnimationType RadPopupControlBase.FitToScreenMode RadPopupControlBase.ScreenSpaceMode RadPopupControlBase.AlignmentRectangleOverlapMode RadPopupControlBase.HorizontalAlignmentCorrectionMode RadPopupControlBase.VerticalAlignmentCorrectionMode RadPopupControlBase.VerticalPopupAlignment RadPopupControlBase.HorizontalPopupAlignment RadPopupControlBase.CreateParams RadPopupControlBase.OwnerElement RadPopupControlBase.OwnerPopup RadPopupControlBase.LastShowDpiScaleFactor RadPopupControlBase.WindowsSettings RadPopupControlBase.Children RadPopupControlBase.MouseWheel RadPopupControlBase.FadeAnimationFinished RadPopupControlBase.PopupOpening RadPopupControlBase.PopupOpened RadPopupControlBase.PopupClosing RadPopupControlBase.PopupClosed RadControl.isResizing2 RadControl.isDisposing2 RadControl.invalidResizeRect RadControl.isAccessibilityRequested RadControl.Construct() RadControl.CreateBehavior() RadControl.CreateRootElement() RadControl.CreateChildItems(RadElement) RadControl.InitializeRootElement(RootRadElement) RadControl.LoadElementTree() RadControl.LoadElementTree(Size) RadControl.SetBackColorThemeOverrides() RadControl.ResetBackColorThemeOverrides() RadControl.SetForeColorThemeOverrides() RadControl.ResetForeColorThemeOverrides() RadControl.OnKeyDown(KeyEventArgs) RadControl.OnKeyUp(KeyEventArgs) RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs) RadControl.OnKeyPress(KeyPressEventArgs) RadControl.OnClick(EventArgs) RadControl.OnDoubleClick(EventArgs) RadControl.OnMouseUp(MouseEventArgs) RadControl.OnMouseEnter(EventArgs) RadControl.OnMouseLeave(EventArgs) RadControl.OnMouseHover(EventArgs) RadControl.OnMouseWheel(MouseEventArgs) RadControl.OnMouseCaptureChanged(EventArgs) RadControl.OnGotFocus(EventArgs) RadControl.OnLostFocus(EventArgs) RadControl.OnCreateControl() RadControl.OnHandleDestroyed(EventArgs) RadControl.OnParentChanged(EventArgs) RadControl.OnVisibleChanged(EventArgs) RadControl.OnFontChanged(EventArgs) RadControl.OnForeColorChanged(EventArgs) RadControl.OnBackColorChanged(EventArgs) RadControl.OnEnabledChanged(EventArgs) RadControl.OnBindingContextChanged(EventArgs) RadControl.OnLocationChanged(EventArgs) RadControl.OnPaddingChanged(EventArgs) RadControl.OnRightToLeftChanged(EventArgs) RadControl.OnPaint(PaintEventArgs) RadControl.OnLayout(LayoutEventArgs) RadControl.OnAutoSizeChanged(EventArgs) RadControl.OnInvalidated(RadElement) RadControl.OnCaptureLosing() RadControl.OnThemeChanged() RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs) RadControl.ProcessMnemonic(char) RadControl.ProcessCaptureChangeRequested(RadElement, bool) RadControl.ProcessAutoSizeChanged(bool) RadControl.IsInputKey(Keys) RadControl.GetInputElement() RadControl.BeginInit() RadControl.EndInit() RadControl.OnNotifyPropertyChanged(string) RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs) RadControl.GetPreferredSize(Size) RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified) RadControl.GetRootElementDesiredSize(int, int, int, int) RadControl.OnZoomGesture(ZoomGestureEventArgs) RadControl.OnRotateGesture(RotateGestureEventArgs) RadControl.OnPanGesture(PanGestureEventArgs) RadControl.OnTwoFingerTapGesture(GestureEventArgs) RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs) RadControl.OnGesture(GestureEventArgs) RadControl.ProcessGesture(Message) RadControl.EnableGesture(GestureType) RadControl.DisableGesture(GestureType) RadControl.Refresh() RadControl.SuspendUpdate() RadControl.ResumeUpdate() RadControl.ResumeUpdate(bool) RadControl.InvokeLayoutCallback(LayoutCallback) RadControl.RegisterHostedControl(RadHostItem) RadControl.UnregisterHostedControl(RadHostItem, bool) RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject) RadControl.GetPlainText() RadControl.ShouldSerializeProperty(RadProperty) RadControl.ShouldSerializeProperty(RadProperty, RadObject) RadControl.ResetProperty(RadProperty, RadObject) RadControl.CanEditElementAtDesignTime(RadElement) RadControl.ProcessCodedUIMessage(ref IPCMessage) RadControl.FindPropertyInChildren(RadControl, IPCMessage) RadControl.ScaleControl(SizeF, BoundsSpecified) RadControl.PerformRadAutoScale(BoundsSpecified?) RadControl.SetRadAutoScale(bool) RadControl.EnableDpiScaling RadControl.EnableRadAutoScale RadControl.EnableRadFormInitialDpiScaling RadControl.EnableImageDpiScaling RadControl.EnableSvgImages RadControl.IsLoaded RadControl.ElementTree RadControl.UseCompatibleTextRenderingDefaultValue RadControl.Behavior RadControl.RootElement RadControl.Padding RadControl.ThemeName RadControl.Text RadControl.EnableTheming RadControl.ImageList RadControl.ImageScalingSize RadControl.UseCompatibleTextRendering RadControl.AutoSize RadControl.MaximumSize RadControl.MinimumSize RadControl.Focusable RadControl.Site RadControl.IsInitializing RadControl.SmallImageList RadControl.SmallImageScalingSize RadControl.IsDesignMode RadControl.IsDisplayed RadControl.FocusedElement RadControl.AllowShowFocusCues RadControl.ShowItemToolTips RadControl.CommandBindings RadControl.EnableKeyMap RadControl.BackColor RadControl.ForeColor RadControl.Font RadControl.ValidationCancel RadControl.EnableAnalytics RadControl.AnalyticsName RadControl.EnableRadAccessibilityObjects RadControl.EnableCodedUITests RadControl.EnableCodedUITestsDefaultValue RadControl.EnableUIAutomation RadControl.EnableUIAutomationDefaultValue RadControl.ElementInvalidated RadControl.ToolTipTextNeeded RadControl.ScreenTipNeeded RadControl.ThemeNameChanged RadControl.Initialized RadControl.PropertyChanged RadControl.ZoomGesture RadControl.RotateGesture RadControl.PanGesture RadControl.TwoFingerTapGesture RadControl.PressAndTapGesture ScrollableControl.ScrollStateAutoScrolling ScrollableControl.ScrollStateHScrollVisible ScrollableControl.ScrollStateVScrollVisible ScrollableControl.ScrollStateUserHasScrolled ScrollableControl.ScrollStateFullDrag ScrollableControl.AdjustFormScrollbars(bool) ScrollableControl.GetScrollState(int) ScrollableControl.OnPaintBackground(PaintEventArgs) ScrollableControl.SetDisplayRectLocation(int, int) ScrollableControl.ScrollControlIntoView(Control) ScrollableControl.ScrollToControl(Control) ScrollableControl.OnScroll(ScrollEventArgs) ScrollableControl.SetAutoScrollMargin(int, int) ScrollableControl.SetScrollState(int, bool) ScrollableControl.AutoScroll ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollMinSize ScrollableControl.DisplayRectangle ScrollableControl.HScroll ScrollableControl.HorizontalScroll ScrollableControl.VScroll ScrollableControl.VerticalScroll ScrollableControl.Scroll Control.GetAccessibilityObjectById(int) Control.SetAutoSizeMode(AutoSizeMode) Control.GetAutoSizeMode() Control.AccessibilityNotifyClients(AccessibleEvents, int) Control.AccessibilityNotifyClients(AccessibleEvents, int, int) Control.BeginInvoke(Delegate) Control.BeginInvoke(Delegate, params object[]) Control.BringToFront() Control.Contains(Control) Control.CreateControlsInstance() Control.CreateGraphics() Control.CreateHandle() Control.CreateControl() Control.DefWndProc(ref Message) Control.DestroyHandle() Control.DoDragDrop(object, DragDropEffects) Control.DrawToBitmap(Bitmap, Rectangle) Control.EndInvoke(IAsyncResult) Control.FindForm() Control.GetTopLevel() Control.RaiseKeyEvent(object, KeyEventArgs) Control.RaiseMouseEvent(object, MouseEventArgs) Control.Focus() Control.FromChildHandle(IntPtr) Control.FromHandle(IntPtr) Control.GetChildAtPoint(Point, GetChildAtPointSkip) Control.GetChildAtPoint(Point) Control.GetContainerControl() Control.GetScaledBounds(Rectangle, SizeF, BoundsSpecified) Control.GetNextControl(Control, bool) Control.GetStyle(ControlStyles) Control.InitLayout() Control.Invalidate(Region) Control.Invalidate(Region, bool) Control.Invalidate() Control.Invalidate(bool) Control.Invalidate(Rectangle) Control.Invalidate(Rectangle, bool) Control.Invoke(Delegate) Control.Invoke(Delegate, params object[]) Control.InvokePaint(Control, PaintEventArgs) Control.InvokePaintBackground(Control, PaintEventArgs) Control.IsKeyLocked(Keys) Control.IsInputChar(char) Control.IsMnemonic(char, string) Control.LogicalToDeviceUnits(int) Control.LogicalToDeviceUnits(Size) Control.ScaleBitmapLogicalToDevice(ref Bitmap) Control.NotifyInvalidate(Rectangle) Control.InvokeOnClick(Control, EventArgs) Control.OnBackgroundImageChanged(EventArgs) Control.OnBackgroundImageLayoutChanged(EventArgs) Control.OnCausesValidationChanged(EventArgs) Control.OnContextMenuChanged(EventArgs) Control.OnContextMenuStripChanged(EventArgs) Control.OnCursorChanged(EventArgs) Control.OnDockChanged(EventArgs) Control.OnNotifyMessage(Message) Control.OnParentBackColorChanged(EventArgs) Control.OnParentBackgroundImageChanged(EventArgs) Control.OnParentBindingContextChanged(EventArgs) Control.OnParentCursorChanged(EventArgs) Control.OnParentEnabledChanged(EventArgs) Control.OnParentFontChanged(EventArgs) Control.OnParentForeColorChanged(EventArgs) Control.OnParentRightToLeftChanged(EventArgs) Control.OnParentVisibleChanged(EventArgs) Control.OnPrint(PaintEventArgs) Control.OnTabIndexChanged(EventArgs) Control.OnTabStopChanged(EventArgs) Control.OnTextChanged(EventArgs) Control.OnClientSizeChanged(EventArgs) Control.OnControlAdded(ControlEventArgs) Control.OnControlRemoved(ControlEventArgs) Control.OnHandleCreated(EventArgs) Control.OnDragEnter(DragEventArgs) Control.OnDragOver(DragEventArgs) Control.OnDragLeave(EventArgs) Control.OnDragDrop(DragEventArgs) Control.OnGiveFeedback(GiveFeedbackEventArgs) Control.OnEnter(EventArgs) Control.InvokeGotFocus(Control, EventArgs) Control.OnHelpRequested(HelpEventArgs) Control.OnInvalidated(InvalidateEventArgs) Control.OnLeave(EventArgs) Control.InvokeLostFocus(Control, EventArgs) Control.OnMarginChanged(EventArgs) Control.OnMouseDoubleClick(MouseEventArgs) Control.OnDpiChangedBeforeParent(EventArgs) Control.OnDpiChangedAfterParent(EventArgs) Control.OnMove(EventArgs) Control.OnQueryContinueDrag(QueryContinueDragEventArgs) Control.OnRegionChanged(EventArgs) Control.OnResize(EventArgs) Control.OnSizeChanged(EventArgs) Control.OnChangeUICues(UICuesEventArgs) Control.OnStyleChanged(EventArgs) Control.OnSystemColorsChanged(EventArgs) Control.OnValidating(CancelEventArgs) Control.OnValidated(EventArgs) Control.RescaleConstantsForDpi(int, int) Control.PerformLayout() Control.PerformLayout(Control, string) Control.PointToClient(Point) Control.PointToScreen(Point) Control.PreProcessMessage(ref Message) Control.PreProcessControlMessage(ref Message) Control.ProcessCmdKey(ref Message, Keys) Control.ProcessDialogKey(Keys) Control.ProcessKeyEventArgs(ref Message) Control.ProcessKeyMessage(ref Message) Control.ProcessKeyPreview(ref Message) Control.RaiseDragEvent(object, DragEventArgs) Control.RaisePaintEvent(object, PaintEventArgs) Control.RecreateHandle() Control.RectangleToClient(Rectangle) Control.RectangleToScreen(Rectangle) Control.ReflectMessage(IntPtr, ref Message) Control.ResetMouseEventArgs() Control.ResetText() Control.ResumeLayout() Control.ResumeLayout(bool) Control.Scale(SizeF) Control.Select() Control.Select(bool, bool) Control.SelectNextControl(Control, bool, bool, bool, bool) Control.SendToBack() Control.SetBounds(int, int, int, int) Control.SetBounds(int, int, int, int, BoundsSpecified) Control.SetClientSizeCore(int, int) Control.SizeFromClientSize(Size) Control.SetStyle(ControlStyles, bool) Control.SetTopLevel(bool) Control.RtlTranslateAlignment(HorizontalAlignment) Control.RtlTranslateAlignment(LeftRightAlignment) Control.RtlTranslateAlignment(ContentAlignment) Control.RtlTranslateHorizontal(HorizontalAlignment) Control.RtlTranslateLeftRight(LeftRightAlignment) Control.RtlTranslateContent(ContentAlignment) Control.SuspendLayout() Control.Update() Control.UpdateBounds() Control.UpdateBounds(int, int, int, int) Control.UpdateBounds(int, int, int, int, int, int) Control.UpdateZOrder() Control.UpdateStyles() Control.OnImeModeChanged(EventArgs) Control.AccessibilityObject Control.AccessibleDefaultActionDescription Control.AccessibleDescription Control.AccessibleName Control.AccessibleRole Control.AllowDrop Control.Anchor Control.AutoScrollOffset Control.LayoutEngine Control.BackgroundImage Control.BackgroundImageLayout Control.BindingContext Control.Bottom Control.Bounds Control.CanFocus Control.CanRaiseEvents Control.CanSelect Control.Capture Control.CheckForIllegalCrossThreadCalls Control.ClientRectangle Control.ClientSize Control.CompanyName Control.ContainsFocus Control.ContextMenu Control.ContextMenuStrip Control.Controls Control.Created Control.Cursor Control.DataBindings Control.DefaultBackColor Control.DefaultCursor Control.DefaultFont Control.DefaultForeColor Control.DefaultMargin Control.DefaultMaximumSize Control.DefaultMinimumSize Control.DefaultPadding Control.DefaultSize Control.DeviceDpi Control.IsDisposed Control.Disposing Control.Dock Control.DoubleBuffered Control.Enabled Control.Focused Control.FontHeight Control.Handle Control.HasChildren Control.Height Control.IsHandleCreated Control.InvokeRequired Control.IsAccessible Control.IsMirrored Control.Left Control.Location Control.Margin Control.ModifierKeys Control.MouseButtons Control.MousePosition Control.Name Control.Parent Control.ProductName Control.ProductVersion Control.RecreatingHandle Control.Region Control.RenderRightToLeft Control.ResizeRedraw Control.Right Control.RightToLeft Control.ScaleChildren Control.Size Control.TabIndex Control.TabStop Control.Tag Control.Top Control.TopLevelControl Control.ShowKeyboardCues Control.ShowFocusCues Control.UseWaitCursor Control.Visible Control.Width Control.PreferredSize Control.CanEnableIme Control.DefaultImeMode Control.ImeMode Control.ImeModeBase Control.PropagatingImeMode Control.BackColorChanged Control.BackgroundImageChanged Control.BackgroundImageLayoutChanged Control.BindingContextChanged Control.CausesValidationChanged Control.ClientSizeChanged Control.ContextMenuChanged Control.ContextMenuStripChanged Control.CursorChanged Control.DockChanged Control.EnabledChanged Control.FontChanged Control.ForeColorChanged Control.LocationChanged Control.MarginChanged Control.RegionChanged Control.RightToLeftChanged Control.SizeChanged Control.TabIndexChanged Control.TabStopChanged Control.TextChanged Control.VisibleChanged Control.Click Control.ControlAdded Control.ControlRemoved Control.DragDrop Control.DragEnter Control.DragOver Control.DragLeave Control.GiveFeedback Control.HandleCreated Control.HandleDestroyed Control.HelpRequested Control.Invalidated Control.PaddingChanged Control.Paint Control.QueryContinueDrag Control.QueryAccessibilityHelp Control.DoubleClick Control.Enter Control.GotFocus Control.KeyDown Control.KeyPress Control.KeyUp Control.Layout Control.Leave Control.LostFocus Control.MouseClick Control.MouseDoubleClick Control.MouseCaptureChanged Control.MouseDown Control.MouseEnter Control.MouseLeave Control.DpiChangedBeforeParent Control.DpiChangedAfterParent Control.MouseHover Control.MouseMove Control.MouseUp Control.Move Control.PreviewKeyDown Control.Resize Control.ChangeUICues Control.StyleChanged Control.SystemColorsChanged Control.Validating Control.Validated Control.ParentChanged Control.ImeModeChanged Component.Dispose() Component.GetService(Type) Component.ToString() Component.Events Component.Container Component.DesignMode Component.Disposed MarshalByRefObject.MemberwiseClone(bool) MarshalByRefObject.GetLifetimeService() MarshalByRefObject.InitializeLifetimeService() MarshalByRefObject.CreateObjRef(Type) Show more
Initializes a new instance of the RadDropDownMenu
Initializes a new instance of the RadDropDownMenu
Declaration
public RadDropDownMenu ( RadElement ownerElement)
Parameters
RadElement
The RadElement
This property is not relevant for this class.
Declaration
[ Browsable ( false ) ]
public bool { get ; set ; }
Property Value
bool
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
Gets or sets the image displayed in the header column of the menu.
Declaration
public Image HeaderImage { get ; set ; }
Property Value
Image
Gets or sets the text displayed in the header column of the menu.
Declaration
public string { get ; set ; }
Property Value
string
Gets or sets a value indicating whether the drop-down menu contains one or two columns of items.
This property is currently not implemented and always returns false.
Declaration
public virtual bool { get ; set ; }
Property Value
bool
Gets or sets the popup element that contains the menu items and provides the visual representation of the drop-down menu.
Declaration
public RadElement PopupElement { get ; set ; }
Property Value
RadElement
Gets the root component tree handler by traversing up the popup ownership hierarchy to find the topmost control's tree handler.
Gets or sets the theme class name for the drop-down menu. The theme class name resolution follows a hierarchy:
checking owner inheritance, local settings, owner control theme capability, and finally the default class name.
Determines whether the popup can be closed for the specified reason, considering owner element state and mouse interaction.
Determines whether the drop-down menu can handle navigation with the specified key.
Declaration
public override bool CanNavigate ( Keys keyData)
Parameters
Keys
The key data to evaluate for navigation capability.
Returns
bool
True if the key can be used for navigation; otherwise, false.
Overrides
RadItemsPopupControl.CanNavigate(Keys)
Determines whether the specified menu item can be processed for user interaction.
Declaration
protected virtual bool CanProcessItem ( RadMenuItemBase menuItem)
Parameters
RadMenuItemBase
The menu item to evaluate.
Returns
bool
True if the menu item is not null and is enabled; otherwise, false.
Determines whether the drop-down menu can process the specified mnemonic character.
Declaration
public override bool CanProcessMnemonic ( char )
Parameters
char
The character to evaluate for mnemonic processing.
Returns
bool
True if the character can be processed as a mnemonic; otherwise, false.
Overrides
RadItemsPopupControl.CanProcessMnemonic(char)
Checks whether navigation is possible with the specified key based on the current selection and menu state.
Declaration
protected virtual bool CheckCanNavigate ( Keys keyData)
Parameters
Keys
The key to evaluate for navigation capability.
Returns
bool
True if navigation is possible with the specified key; otherwise, false.
Recursively checks whether the specified mnemonic character can be processed by the items control or its child menus.
Declaration
protected virtual bool CheckCanProcessMnemonic ( IItemsControl itemsControl, char )
Parameters
IItemsControl
The items control to check for mnemonic processing capability.
char
The character to evaluate for mnemonic processing.
Returns
bool
True if the character can be processed as a mnemonic; otherwise, false.
Determines whether this control defines the theme for the specified element, considering owner inheritance and element type.
Declaration
public override bool ControlDefinesThemeForElement ( RadElement element)
Parameters
RadElement
The element to evaluate for theme definition.
Returns
bool
True if this control defines the theme for the element; otherwise, false.
Overrides
RadControl.ControlDefinesThemeForElement(RadElement)
Creates an accessibility object for the drop-down menu to support assistive technologies.
Creates the popup element that will contain the menu items for the drop-down menu.
Releases the unmanaged resources used by the RadDropDownMenu
Declaration
protected override void Dispose ( bool )
Parameters
bool
True to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides
RadItemsPopupControl.Dispose(bool)
Handles the clicking action on a menu item, managing selection, popup closure, and child menu display.
Declaration
protected virtual void DoOnItemClicked ( RadMenuItemBase menuItem, MouseEventArgs e)
Parameters
RadMenuItemBase
The menu item that was clicked.
MouseEventArgs
The mouse event arguments.
Ensures that an enabled item is selected by cycling through items in the specified direction until an enabled item is found.
Declaration
protected virtual void EnsureItemEnabled ( RadItem item, bool )
Parameters
RadItem
The currently selected item to start from.
bool
True to search upward; false to search downward.
Gets the menu item at the specified location by traversing up the element tree.
Declaration
protected RadMenuItemBase GetMenuItemAtPoint ( Point location)
Parameters
Point
The location to search for a menu item.
Returns
RadMenuItemBase
The RadMenuItemBase
Gets the screen location of the owner element used for positioning the drop-down menu.
Declaration
protected virtual Point GetOwnerScreenLocation ( )
Returns
Point
The screen coordinates of the owner element.
Gets the size of the owner element used for positioning calculations.
Declaration
protected virtual Size GetOwnerSize ( )
Returns
Size
The size of the owner element, or Empty
Initializes the child elements of the drop-down menu, setting up the root element properties and creating the popup element if necessary.
Declaration
protected virtual void InitializeChildren ( )
Called when a drop-down location is needed and provides an opportunity to customize the location.
Declaration
protected virtual Point OnDropDownLocationNeeded ( Point point)
Parameters
Point
The requested location point.
Returns
Point
The location where the drop-down should be displayed.
Handles item deselection events, updating the selected state of the menu item.
Handles item selection events, updating the selected state and accessibility notifications.
Handles changes to the menu items collection, updating hierarchy relationships and ownership.
Declaration
protected virtual void OnItemsChanged ( RadItemCollection changed, RadItem target, ItemsChangeOperation operation)
Parameters
RadItemCollection
The collection that was changed.
RadItem
The menu item that was affected by the change.
ItemsChangeOperation
The type of change operation that occurred.
Handles key down events for menu navigation, item selection, and mnemonic processing.
Handles the load event for the drop-down menu, setting up image list and binding context from the owner element if available.
Declaration
protected override void OnLoad ( Size desiredSize)
Parameters
Size
The desired size for the menu.
Overrides
RadControl.OnLoad(Size)
Handles mouse down events for the drop-down menu, processing menu item interactions and child drop-down display.
Handles mouse move events for the drop-down menu, managing item selection and child menu timing.
Handles mouse wheel events to scroll the menu content when the vertical scrollbar is visible.
Declaration
public override bool OnMouseWheel ( Control target, int )
Parameters
Control
The target control for the mouse wheel event.
int
The wheel delta value indicating scroll direction and amount.
Returns
bool
True if the mouse wheel event was handled; otherwise, false.
Overrides
RadPopupControlBase.OnMouseWheel(Control, int)
Handles screen tip needed events by delegating to the root owner control in the hierarchy.
Handles tooltip text needed events by delegating to the root owner control in the hierarchy.
Performs a click action on the specified menu item, handling child menu expansion or popup closure as appropriate.
Declaration
protected void PerformItemClick ( RadMenuItemBase menuItem)
Parameters
RadMenuItemBase
The menu item to perform the click action on.
Performs the click action on a menu item if conditions are met (not in design time and not under mouse).
Declaration
protected virtual void PerformMenuItemClick ( RadMenuItemBase menuItem)
Parameters
RadMenuItemBase
The menu item to perform the click action on.
Processes dialog character input for the drop-down menu.
Declaration
protected override bool ProcessDialogChar ( char )
Parameters
char
The character code to process.
Returns
bool
Always returns true to indicate the character was processed.
Overrides
Control.ProcessDialogChar(char)
Processes left and right navigation keys for expanding/collapsing child menus and closing parent menus.
Declaration
protected virtual bool ProcessLeftRightNavigationKey ( bool )
Parameters
bool
True for left navigation; false for right navigation.
Returns
bool
True if the navigation was processed; otherwise, false.
Processes mnemonic key input to find and activate matching menu items.
Declaration
protected virtual bool ProcessMnemonic ( Keys keyData)
Parameters
Keys
The key data to process as a mnemonic.
Returns
bool
True if a mnemonic was found and processed; otherwise, false.
Processes up and down navigation keys, selecting the appropriate item in the specified direction.
Declaration
protected virtual bool ProcessUpDownNavigationKey ( bool )
Parameters
bool
True for up navigation; false for down navigation.
Returns
bool
True if the navigation was processed; otherwise, false.
Sets the visible state of the control, managing popup positioning and selection state.
Declaration
protected override void SetVisibleCore ( bool value )
Parameters
bool
True to make the control visible; false to hide it.
Overrides
Control.SetVisibleCore(bool)
Displays the RadDropDownMenu
Declaration
public void Show ( Control control, Point point)
Parameters
Control
The control that serves as the reference point for positioning the menu.
Point
The offset from the control's location where the menu should be displayed.
Displays the RadDropDownMenu
Declaration
public void Show ( Control control, Point point, RadDirection popupDirection)
Parameters
Control
The control that serves as the reference point for positioning the menu.
Point
The offset from the control's location where the menu should be displayed.
RadDirection
The direction in which the menu should open.
Displays the RadDropDownMenu
Declaration
public void Show ( Control control, int , int )
Parameters
Control
The control that serves as the reference point for positioning the menu.
int
The horizontal offset from the control's location, in pixels.
int
The vertical offset from the control's location, in pixels.
Declaration
public void Show ( Point point)
Parameters
Point
The screen coordinates where the menu should be displayed.
Displays the RadDropDownMenu
Declaration
public void Show ( Point point, RadDirection popupDirection)
Parameters
Point
The screen coordinates where the menu should be displayed.
RadDirection
The direction in which the menu should open.
Declaration
public void Show ( RadItem item, Point point)
Parameters
RadItem
The RadItem
Point
The offset from the item's location where the menu should be displayed.
Declaration
public void Show ( RadItem item, Point point, RadDirection popupDirection)
Parameters
RadItem
The RadItem
Point
The offset from the item's location where the menu should be displayed.
RadDirection
The direction in which the menu should open.
Declaration
public void Show ( RadItem item, int , RadDirection popupDirection)
Parameters
RadItem
The RadItem
int
The offset from the owner element, in pixels.
RadDirection
The direction in which the menu should open.
Declaration
public void Show ( RadItem item, int , int )
Parameters
RadItem
The RadItem
int
The horizontal offset from the item's location, in pixels.
int
The vertical offset from the item's location, in pixels.
Declaration
public void Show ( int , int )
Parameters
int
The horizontal screen coordinate, in pixels.
int
The vertical screen coordinate, in pixels.
Core implementation for displaying the drop-down menu at the specified location with the given direction and offset.
Handles DPI scaling, theme setup, layout calculation, and popup positioning.
Declaration
protected virtual void ShowCore ( Point point, int , RadDirection popupDirection)
Parameters
Point
The screen coordinates where the menu should be displayed.
int
The offset from the owner element, in pixels.
RadDirection
The direction in which the menu should open.