Class

RadDropDownButtonElement

Initializes a new instance of the DropDownButtonElement class.

Declaration

public RadDropDownButtonElement()

Declaration

public static RadProperty DisplayStyleProperty

Field Value

Declaration

public static RadProperty ImageAlignmentProperty

Field Value

Declaration

public static RadProperty ImageIndexProperty

Field Value

Declaration

public static RadProperty ImageKeyProperty

Field Value

Declaration

public static RadProperty ImageProperty

Field Value

Declaration

public static RadProperty IsDropDownShownProperty

Field Value

Declaration

public static RadProperty IsPressedProperty

Field Value

Declaration

public static RadProperty MouseOverStateProperty

Field Value

Declaration

public static RadProperty ShowArrowProperty

Field Value

Declaration

public static RadProperty SvgImageProperty

Field Value

Declaration

public static RadProperty TextAlignmentProperty

Field Value

Declaration

public static RadProperty TextImageRelationProperty

Field Value

Declaration

protected DropDownEditorLayoutPanel layoutPanel

Field Value

Declaration

public static Dictionary<RadProperty, RadProperty> mappedStyleProperties

Field Value

Declaration

protected RadDropDownButtonPopup menu

Field Value

Gets the action button

Declaration

[Browsable(false)]
public RadButtonElement ActionButton { get; }

Property Value

Gets the arrow button

Declaration

[Browsable(false)]
public RadArrowButtonElement ArrowButton { get; }

Property Value

Gets or sets the minimum size of the arrow button

Declaration

public Size ArrowButtonMinSize { get; set; }

Property Value

Gets or sets a value indicating the position where the arrow button appears in drop-down button.

Declaration

[Browsable(true)]
public virtual DropDownButtonArrowPosition ArrowPosition { get; set; }

Property Value

Declaration

public override bool AutoToolTip { get; set; }

Property Value

Overrides RadElement.AutoToolTip

Gets the border element

Declaration

[Browsable(false)]
public BorderPrimitive BorderElement { get; }

Property Value

Specifies the logical combination of image and text primitives in the element.

Declaration

[Browsable(true)]
public DisplayStyle DisplayStyle { get; set; }

Property Value

Gets or sets a value indicating the direction in which the dropdown item emerges from its parent container.

Declaration

[Browsable(true)]
public RadDirection DropDownDirection { get; set; }

Property Value

Gets or sets value indicating whether DropDownMenu will have the same class name as the owner control or its own. True means that the same class name will be used as the control that opened the dropdown.

Declaration

public bool DropDownInheritsThemeClassName { get; set; }

Property Value

Implements IDropDownMenuOwner.DropDownInheritsThemeClassName

Gets the drop down menu

Declaration

[Browsable(false)]
public RadDropDownMenu DropDownMenu { get; }

Property Value

Gets or sets the expand arrow button

Declaration

[Browsable(false)]
public bool ExpandArrowButton { get; set; }

Property Value

Indicates whether the DropDown of the button should have two columns or one column.

Declaration

[Browsable(true)]
public bool HasTwoColumnDropDown { get; set; }

Property Value

Gets or sets the image that is displayed on a button element.

Declaration

[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image Image { get; set; }

Property Value

Implements IImageElement.Image

Gets or sets the alignment of image content on the drawing surface.

Declaration

public virtual ContentAlignment ImageAlignment { get; set; }

Property Value

Gets or sets the image list index value of the image displayed on the button control.

Declaration

[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndex { get; set; }

Property Value

Implements IImageElement.ImageIndex

Gets or sets the key accessor for the image in the ImageList.

Declaration

[RelatedImageList("ElementTree.Control.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

Implements IImageElement.ImageKey

Gets a value indicating whether the drop down is shown

Declaration

[Browsable(false)]
public bool IsDropDownShown { get; }

Property Value

Gets a value indicating whether the button item is in the pressed state.

Declaration

[Browsable(false)]
public bool IsPressed { get; }

Property Value

Gets the Items collection where you can add and remove items from the DropDownButton.

Declaration

[RadEditItemsAction]
public RadItemOwnerCollection Items { get; }

Property Value

Implements IItemsOwner.Items

Declaration

[Browsable(false)]
public DropDownEditorLayoutPanel Layout { get; }

Property Value

Gets or sets a value indicating whether an arrow button is displayed on the drop-down buuton.

Declaration

[Browsable(true)]
public virtual bool ShowArrow { get; set; }

Property Value

Gets or sets the vector image that is displayed on a button element.

Declaration

public RadSvgImage SvgImage { get; set; }

Property Value

Gets or sets the alignment of text content on the drawing surface.

Declaration

public virtual ContentAlignment TextAlignment { get; set; }

Property Value

Gets or sets the position of text and image relative to each other.

Declaration

public virtual TextImageRelation TextImageRelation { get; set; }

Property Value

Declaration

public override string ToolTipText { get; set; }

Property Value

Overrides RadItem.ToolTipText

Called by the element when constructed. Allows inheritors to build the element tree.

Declaration

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

Declaration

protected virtual RadDropDownButtonPopup CreateDropDown()

Returns

Releases managed resources used by this element.

Declaration

protected override void DisposeManagedResources()

Overrides RadItem.DisposeManagedResources()

Declaration

protected override void DoClick(EventArgs e)

Parameters

Overrides RadElement.DoClick(EventArgs)

Declaration

public ISite GetSite()

Returns

Implements ISiteProvider.GetSite()

Hides the drop down menu.

Declaration

public virtual void HideDropDown()

Initializes the fields of this instance with their default values.

Declaration

protected override void InitializeFields()

Overrides RadItem.InitializeFields()

Maps a style property to another property. This method is used to map corresponding properties of LightVisualElement instances and BasePrimitive instances.

Declaration

public override RadProperty MapStyleProperty(RadProperty propertyToMap, string settingType)

Parameters

Returns

Overrides RadElement.MapStyleProperty(RadProperty, string)

Determines whether the event is passed up in the control hierarchy.

Declaration

protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)

Parameters

Overrides RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)

Raises the DropDownClosed event.

Declaration

protected virtual void OnDropDownClosed(EventArgs e)

Parameters

Fires when the drop-down of the button is about to close.

Declaration

protected virtual void OnDropDownClosing(RadPopupClosingEventArgs args)

Parameters

Raises the DropDownOpened event.

Declaration

protected virtual void OnDropDownOpened(EventArgs e)

Parameters

Raises the DropDownOpening event.

Declaration

protected virtual void OnDropDownOpening(CancelEventArgs e)

Parameters

Raises the KeyDown event.

Declaration

protected override void OnKeyDown(KeyEventArgs e)

Parameters

Overrides RadItem.OnKeyDown(KeyEventArgs)

Raises the KeyUp event.

Declaration

protected override void OnKeyUp(KeyEventArgs e)

Parameters

Overrides RadItem.OnKeyUp(KeyEventArgs)

Called when a mouse button is released over the item.

Declaration

protected override void OnMouseUp(MouseEventArgs e)

Parameters

Overrides RadItem.OnMouseUp(MouseEventArgs)

Called when a property value has changed, handling item-specific property change logic including text, visual state, and animation properties.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Determines whether the property defined by the provided property descriptor should be serialized.

Declaration

public override bool? ShouldSerializeProperty(PropertyDescriptor property)

Parameters

Returns

Overrides RadItem.ShouldSerializeProperty(PropertyDescriptor)

Shows the drop down menu.

Declaration

public virtual void ShowDropDown()

Shows the drop down menu at given location

Declaration

public virtual void ShowDropDown(Point location)

Parameters

Declaration

protected virtual void ShowDropDownOnClick()

Occurs when the drop-down window has closed.

Declaration

[Browsable(true)]
public event EventHandler DropDownClosed

Event Value

Occurs when the drop-down window is about to close.

Declaration

[Browsable(true)]
public event RadPopupClosingEventHandler DropDownClosing

Event Value

Occurs when the drop-down has opened.

Declaration

[Browsable(true)]
public event EventHandler DropDownOpened

Event Value

Occurs when the drop-down is opening.

Declaration

[Browsable(true)]
public event CancelEventHandler DropDownOpening

Event Value