Class RadDropDownButton

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.

Inheritance
System.Object
RadControl
RadDropDownButton
RadApplicationMenu
RadSplitButton
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadDropDownButton : RadControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider

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
public override bool AllowShowFocusCues { get; set; }
Property Value
System.Boolean

Overrides

ArrowDirection

Declaration
public ArrowDirection ArrowDirection { get; set; }
Property Value
ArrowDirection

DefaultSize

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

DisplayStyle

Declaration
public virtual DisplayStyle DisplayStyle { get; set; }
Property Value
DisplayStyle

DropDownButtonElement

Gets the instance of RadDropDownButtonElement wrapped by this control. RadDropDownButtonElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadDropDownButton.

Declaration
public RadDropDownButtonElement DropDownButtonElement { get; }
Property Value
RadDropDownButtonElement

DropDownDirection

Declaration
public RadDirection DropDownDirection { get; set; }
Property Value
RadDirection

Image

Declaration
[RadDescription("Image", typeof(RadDropDownButtonElement))]
public Image Image { get; set; }
Property Value
System.Drawing.Image

ImageAlignment

Declaration
public ContentAlignment ImageAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

ImageIndex

Declaration
[RadDefaultValue("ImageIndex", typeof(RadDropDownButtonElement))]
[RadDescription("ImageIndex", typeof(RadDropDownButtonElement))]
public int ImageIndex { get; set; }
Property Value
System.Int32

ImageKey

Declaration
[RadDefaultValue("ImageKey", typeof(RadDropDownButtonElement))]
[RadDescription("ImageKey", typeof(RadDropDownButtonElement))]
public virtual string ImageKey { get; set; }
Property Value
System.String

IsPressed

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

Items

Declaration
[RadEditItemsAction]
public virtual RadItemOwnerCollection Items { get; }
Property Value
RadItemOwnerCollection

ShowArrow

Declaration
[RadDescription("ShowArrow", typeof(RadDropDownButtonElement))]
[RadDefaultValue("ShowArrow", typeof(RadDropDownButtonElement))]
public bool ShowArrow { get; set; }
Property Value
System.Boolean

Text

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

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

Overrides

TextAlignment

Declaration
public ContentAlignment TextAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

TextImageRelation

Declaration
public TextImageRelation TextImageRelation { get; set; }
Property Value
System.Windows.Forms.TextImageRelation

Methods

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

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
RadDropDownButtonElement

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

CreateChildItems(RadElement)

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

Overrides

Dispose(Boolean)

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

Overrides

HideDropDown()

Declaration
public virtual void HideDropDown()

IsInputKey(Keys)

Declaration
protected override bool IsInputKey(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

Returns
System.Boolean

Overrides

OnDropDownClosed(EventArgs)

Declaration
protected virtual void OnDropDownClosed(EventArgs e)
Parameters
System.EventArgs e

OnDropDownOpened(EventArgs)

Declaration
protected virtual void OnDropDownOpened(EventArgs e)
Parameters
System.EventArgs e

OnDropDownOpening(CancelEventArgs)

Declaration
protected virtual void OnDropDownOpening(CancelEventArgs e)
Parameters
System.ComponentModel.CancelEventArgs e

OnGotFocus(EventArgs)

Declaration
protected override void OnGotFocus(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnLostFocus(EventArgs)

Declaration
protected override void OnLostFocus(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnThemeChanged()

Declaration
protected override void OnThemeChanged()
Overrides

ProcessCodedUIMessage(ref IPCMessage)

Declaration
protected override void ProcessCodedUIMessage(ref IPCMessage request)
Parameters
IPCMessage request

Overrides

ProcessMnemonic(Char)

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

Returns
System.Boolean

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
public event EventHandler DropDownClosed
Event Type
System.EventHandler

DropDownOpened

Declaration
public event EventHandler DropDownOpened
Event Type
System.EventHandler

DropDownOpening

Declaration
public event EventHandler DropDownOpening
Event Type
System.EventHandler

Extension Methods