ClassRadDropDownButton
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:
[DefaultBindingProperty("Text")]
public class RadDropDownButton : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProviderInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadDropDownButton
Derived Classes:
Implements:
Inherited Members
Constructors
RadDropDownButton()
Initializes a new instance of the RadDropDownButton class.
Declaration
public RadDropDownButton()Properties
AllowShowFocusCues
Indicates focus cues display, when available, based on the corresponding control type and the current UI state.
Declaration
[Browsable(true)]
public override bool AllowShowFocusCues { get; set; }Property Value
Overrides
ArrowDirection
Gets or sets the direction of the arrow shown on the button.
Declaration
[Browsable(true)]
public ArrowDirection ArrowDirection { get; set; }Property Value
An ArrowDirection value that determines the arrow's direction. The default is Down.
DefaultSize
Declaration
protected override Size DefaultSize { get; }Property Value
Overrides
DisplayStyle
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.
Declaration
[Browsable(true)]
public virtual DisplayStyle DisplayStyle { get; set; }Property Value
One of the DisplayStyle values. The default is ImageAndText.
DropDownButtonElement
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.
Declaration
[Browsable(false)]
public RadDropDownButtonElement DropDownButtonElement { get; }Property Value
A RadDropDownButtonElement that represents the button's visual element.
DropDownDirection
Gets or sets the direction in which the dropdown menu opens.
Declaration
[Browsable(true)]
public RadDirection DropDownDirection { get; set; }Property Value
A RadDirection value that determines the dropdown direction. The default is Down.
ImageAlignment
Declaration
public ContentAlignment ImageAlignment { get; set; }Property Value
ImageIndex
Declaration
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int ImageIndex { get; set; }Property Value
ImageKey
Declaration
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKey { get; set; }Property Value
IsPressed
Gets a value indicating whether the button is currently pressed.
Declaration
[Browsable(false)]
public bool IsPressed { get; }Property Value
true if the button is pressed; otherwise, false.
Items
Gets the collection of items displayed in the dropdown menu.
Declaration
[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }Property Value
A RadItemOwnerCollection containing the items in the dropdown menu.
ShowArrow
Gets or sets a value indicating whether the dropdown arrow is displayed on the button.
Declaration
[Browsable(true)]
public bool ShowArrow { get; set; }Property Value
true to show the dropdown arrow; otherwise, false.
SvgImage
Gets or sets the Svg Image.
Text
Gets or sets the text value that is displayed on the button.
Declaration
[Bindable(true)]
[SettingsBindable(true)]
public override string Text { get; set; }Property Value
Overrides
TextAlignment
Declaration
public ContentAlignment TextAlignment { get; set; }Property Value
TextImageRelation
Declaration
public TextImageRelation TextImageRelation { get; set; }Property Value
Methods
ControlDefinesThemeForElement(RadElement)
Checks whether the element's theme is defined by the control.
Declaration
public override bool ControlDefinesThemeForElement(RadElement element)Parameters
element
The element to should be checked.
Returns
true if the control defines theme for this element, false otherwise.
Overrides
Remarks
If true is returned the ThemeResolutionService would not not set any theme to the element to avoid duplicating the style settings of the element.
CreateAccessibilityInstance()
Declaration
protected override AccessibleObject CreateAccessibilityInstance()Returns
Overrides
CreateButtonElement()
Override this method to create custom main element. By default the main element is an instance of RadDropDownButtonElement.
Declaration
protected virtual RadDropDownButtonElement CreateButtonElement()Returns
Instance of the one-and-only child of the root element of RadDropDownButton.
CreateChildItems(RadElement)
Creates and initializes the child elements of the drop-down button.
Declaration
protected override void CreateChildItems(RadElement parent)Parameters
parent
The parent RadElement to which child elements will be added.
Overrides
Dispose(bool)
Declaration
protected override void Dispose(bool disposing)Parameters
disposing
Overrides
HideDropDown()
Declaration
public virtual void HideDropDown()OnDropDownClosed(EventArgs)
Declaration
protected virtual void OnDropDownClosed(EventArgs e)Parameters
e
OnDropDownOpened(EventArgs)
Declaration
protected virtual void OnDropDownOpened(EventArgs e)Parameters
e
OnDropDownOpening(CancelEventArgs)
Declaration
protected virtual void OnDropDownOpening(CancelEventArgs e)Parameters
e
OnGotFocus(EventArgs)
Declaration
protected override void OnGotFocus(EventArgs e)Parameters
e
Overrides
OnLostFocus(EventArgs)
Declaration
protected override void OnLostFocus(EventArgs e)Parameters
e
Overrides
OnThemeChanged()
Declaration
protected override void OnThemeChanged()Overrides
ProcessCodedUIMessage(ref IPCMessage)
Declaration
protected override void ProcessCodedUIMessage(ref IPCMessage request)Parameters
request
IPCMessage
Overrides
ResetBackColorThemeOverrides()
Declaration
protected override void ResetBackColorThemeOverrides()Overrides
ResetForeColorThemeOverrides()
Declaration
protected override void ResetForeColorThemeOverrides()Overrides
SetBackColorThemeOverrides()
Declaration
protected override void SetBackColorThemeOverrides()Overrides
SetForeColorThemeOverrides()
Declaration
protected override void SetForeColorThemeOverrides()Overrides
ShowDropDown()
Declaration
public virtual void ShowDropDown()Events
DropDownClosed
Declaration
[Browsable(true)]
public event EventHandler DropDownClosedEvent Value
DropDownOpened
Declaration
[Browsable(true)]
public event EventHandler DropDownOpenedEvent Value
DropDownOpening
Declaration
[Browsable(true)]
public event EventHandler DropDownOpeningEvent Value