New to Telerik UI for WinForms? Start a free 30-day trial

Represents a drop down button. Essentially the RadDropDownButton class is a simple wrapper for RadDropDownButtonElement.

You can set items that appear when the drop down button is pressed. Also you can configure the visual appearance in numerous ways through themes.

The RadDropDownButtonElement class implements all UI and logic functionality. The RadDropDownButton acts to transfer the events to and from its RadDropDownButtonElementinstance.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[DefaultBindingProperty("Text")]
public class RadDropDownButton : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadDropDownButton...

Derived Classes: RadApplicationMenuRadSplitButton

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.OnKeyDown(KeyEventArgs)RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnKeyPress(KeyPressEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseDown(MouseEventArgs)RadControl.OnMouseUp(MouseEventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseMove(MouseEventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseWheel(MouseEventArgs)RadControl.OnMouseCaptureChanged(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.WndProc(ref Message)RadControl.OnInvalidated(RadElement)RadControl.OnLoad(Size)RadControl.OnCaptureLosing()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)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.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.AutoSizeRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Initializes a new instance of the RadDropDownButton class.

C#
public RadDropDownButton()

Properties

Indicates focus cues display, when available, based on the corresponding control type and the current UI state.

C#
[Browsable(true)]
public override bool AllowShowFocusCues { get; set; }

Overrides: RadControl.AllowShowFocusCues

Gets or sets the direction of the arrow shown on the button.

C#
[Browsable(true)]
public ArrowDirection ArrowDirection { get; set; }
Property Value:

An ArrowDirection value that determines the arrow's direction. The default is Down.

Gets the default control size of 140 by 24 pixels.

C#
protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Gets or sets the display style that determines how text and images are shown on the button. Controls whether the button displays text only, image only, or both text and image.

C#
[Browsable(true)]
public virtual DisplayStyle DisplayStyle { get; set; }
Property Value:

One of the DisplayStyle values. The default is ImageAndText.

Gets the RadDropDownButtonElement that represents the visual element of this drop-down button control. This element contains the visual styling and drop-down behavior logic for the button.

C#
[Browsable(false)]
public RadDropDownButtonElement DropDownButtonElement { get; }
Property Value:

A RadDropDownButtonElement that represents the button's visual element.

Gets or sets the direction in which the dropdown menu opens.

C#
[Browsable(true)]
public RadDirection DropDownDirection { get; set; }
Property Value:

A RadDirection value that determines the dropdown direction. The default is Down.

C#
public Image Image { get; set; }
C#
public ContentAlignment ImageAlignment { get; set; }
C#
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.1026.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int ImageIndex { get; set; }
C#
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.1026.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKey { get; set; }

Gets a value indicating whether the button is currently pressed.

C#
[Browsable(false)]
public bool IsPressed { get; }
Property Value:

true if the button is pressed; otherwise, false.

Gets the collection of items displayed in the dropdown menu.

C#
[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }
Property Value:

A RadItemOwnerCollection containing the items in the dropdown menu.

Gets or sets a value indicating whether the dropdown arrow is displayed on the button.

C#
[Browsable(true)]
public bool ShowArrow { get; set; }
Property Value:

true to show the dropdown arrow; otherwise, false.

Gets or sets the Svg Image.

C#
public RadSvgImage SvgImage { get; set; }

Gets or sets the text value that is displayed on the button.

C#
[Bindable(true)]
[SettingsBindable(true)]
public override string Text { get; set; }

Overrides: RadControl.Text

C#
public ContentAlignment TextAlignment { get; set; }
C#
public TextImageRelation TextImageRelation { get; set; }

Methods

Indicates whether this control supplies theme settings for its drop-down element and button elements.

C#
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters:elementRadElement

The element whose theme ownership is being checked.

Returns:

bool

true only when element has runtime type RadDropDownButtonElement or RadButtonElement.

Overrides: RadControl.ControlDefinesThemeForElement(RadElement)

Uses the standard accessibility object unless Telerik accessibility objects are enabled, in which case the custom object exposes the button and its drop-down child.

C#
protected override AccessibleObject CreateAccessibilityInstance()
Returns:

AccessibleObject

The accessibility object for this control.

Overrides: Control.CreateAccessibilityInstance()

Override this method to create custom main element. By default the main element is an instance of RadDropDownButtonElement.

C#
protected virtual RadDropDownButtonElement CreateButtonElement()
Returns:

RadDropDownButtonElement

Instance of the one-and-only child of the root element of RadDropDownButton.

Creates and initializes the child elements of the drop-down button.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The parent RadElement to which child elements will be added.

Overrides: RadControl.CreateChildItems(RadElement)

Detaches the drop-down event handlers from the child element before disposing the control.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

Whether managed resources should be released.

Overrides: RadControl.Dispose(bool)

C#
public virtual void HideDropDown()

Treats the Down key as an input key when the button has menu items; other keys use the base classification.

C#
protected override bool IsInputKey(Keys keyData)
Parameters:keyDataKeys

The key data to classify.

Returns:

bool

true if the key is handled as input by this control.

Overrides: RadControl.IsInputKey(Keys)

C#
protected virtual void OnDropDownClosed(EventArgs e)
Parameters:eEventArgs
C#
protected virtual void OnDropDownOpened(EventArgs e)
Parameters:eEventArgs
C#
protected virtual void OnDropDownOpening(CancelEventArgs e)
Parameters:eCancelEventArgs

Forwards focus to the drop-down button element after the control receives focus.

C#
protected override void OnGotFocus(EventArgs e)
Parameters:eEventArgs

The event data for the focus change.

Overrides: RadControl.OnGotFocus(EventArgs)

Closes an open drop-down on focus loss unless the pointer is within the menu or its last activated popup.

C#
protected override void OnLostFocus(EventArgs e)
Parameters:eEventArgs

The event data for the focus change.

Overrides: RadControl.OnLostFocus(EventArgs)

Reapplies the action button's current visual state after the control's theme changes.

C#
protected override void OnThemeChanged()

Overrides: RadControl.OnThemeChanged()

Handles coded-UI queries for the menu item count and whether the button has child nodes; other requests are passed to the base implementation.

C#
protected override void ProcessCodedUIMessage(ref IPCMessage request)
Parameters:requestIPCMessage

The coded-UI message to process; handled query results are written to its data.

Overrides: RadControl.ProcessCodedUIMessage(ref IPCMessage)

Opens the drop-down when an enabled Alt+mnemonic matches the button text.

C#
protected override bool ProcessMnemonic(char charCode)
Parameters:charCodechar

The mnemonic character to process.

Returns:

bool

true if the mnemonic opened the drop-down; otherwise, false.

Overrides: RadControl.ProcessMnemonic(char)

Removes the control's background-color and solid-fill theme overrides from the drop-down button element.

C#
protected override void ResetBackColorThemeOverrides()

Overrides: RadControl.ResetBackColorThemeOverrides()

Removes foreground-color overrides from the drop-down and action-button elements, resets the action button's child style value, then reapplies theme settings.

C#
protected override void ResetForeColorThemeOverrides()

Overrides: RadControl.ResetForeColorThemeOverrides()

Applies the control's BackColor to the button and arrow fills in every available visual state, using solid fills.

C#
protected override void SetBackColorThemeOverrides()

Overrides: RadControl.SetBackColorThemeOverrides()

Applies the control's ForeColor to the drop-down button and action-button text across their visual states.

C#
protected override void SetForeColorThemeOverrides()

Overrides: RadControl.SetForeColorThemeOverrides()

C#
public virtual void ShowDropDown()

Events

C#
[Browsable(true)]
public event EventHandler DropDownClosed
C#
[Browsable(true)]
public event EventHandler DropDownOpened
C#
[Browsable(true)]
public event EventHandler DropDownOpening