Represents a rad dropdown button element. The RadDropDownButton control is a simple wrapper for the RadDropDownButtonElement. All UI and logic functionality is implemented in RadDropDownButtonElement class. The RadDropDownButton acts to transfer events to and from its RadDropDownButtonElement instance. RadDropDownButtonElement can be nested in other telerik controls.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[ComVisible(false)]
public class RadDropDownButtonElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IDropDownMenuOwner, ISiteProvider, IItemsOwner, IImageElementInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadDropDownButtonElement...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the DropDownButtonElement class.
public RadDropDownButtonElement()Fields
public static RadProperty DisplayStylePropertypublic static RadProperty ImageAlignmentPropertypublic static RadProperty ImageIndexPropertypublic static RadProperty ImageKeyPropertypublic static RadProperty ImagePropertypublic static RadProperty IsDropDownShownPropertypublic static RadProperty IsPressedPropertyprotected DropDownEditorLayoutPanel layoutPanelmappedStyleProperties
Dictionary<RadProperty, RadProperty>
public static Dictionary<RadProperty, RadProperty> mappedStylePropertiesprotected RadDropDownButtonPopup menupublic static RadProperty MouseOverStatePropertypublic static RadProperty ShowArrowPropertypublic static RadProperty SvgImagePropertypublic static RadProperty TextAlignmentPropertypublic static RadProperty TextImageRelationPropertyProperties
Gets the action button
[Browsable(false)]
public RadButtonElement ActionButton { get; }Gets the arrow button
[Browsable(false)]
public RadArrowButtonElement ArrowButton { get; }Gets or sets the minimum size of the arrow button
public Size ArrowButtonMinSize { get; set; }Gets or sets a value indicating the position where the arrow button appears in drop-down button.
[Browsable(true)]
public virtual DropDownButtonArrowPosition ArrowPosition { get; set; }public override bool AutoToolTip { get; set; }Overrides:
Gets the border element
[Browsable(false)]
public BorderPrimitive BorderElement { get; }Specifies the logical combination of image and text primitives in the element.
[Browsable(true)]
public DisplayStyle DisplayStyle { get; set; }Gets or sets a value indicating the direction in which the dropdown item emerges from its parent container.
[Browsable(true)]
public RadDirection DropDownDirection { get; set; }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.
public bool DropDownInheritsThemeClassName { get; set; }Implements:
Gets the drop down menu
[Browsable(false)]
public RadDropDownMenu DropDownMenu { get; }Gets or sets the expand arrow button
[Browsable(false)]
public bool ExpandArrowButton { get; set; }Indicates whether the DropDown of the button should have two columns or one column.
[Browsable(true)]
public bool HasTwoColumnDropDown { get; set; }Gets or sets the image that is displayed on a button element.
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image Image { get; set; }Implements:
Gets or sets the alignment of image content on the drawing surface.
public virtual ContentAlignment ImageAlignment { get; set; }Gets or sets the image list index value of the image displayed on the button control.
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.2.702.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndex { get; set; }Implements:
Gets or sets the key accessor for the image in the ImageList.
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.2.702.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKey { get; set; }Implements:
Gets a value indicating whether the drop down is shown
[Browsable(false)]
public bool IsDropDownShown { get; }Gets a value indicating whether the button item is in the pressed state.
[Browsable(false)]
public bool IsPressed { get; }Gets the Items collection where you can add and remove items from the DropDownButton.
[RadEditItemsAction]
public RadItemOwnerCollection Items { get; }Implements:
[Browsable(false)]
public DropDownEditorLayoutPanel Layout { get; }Gets or sets a value indicating whether an arrow button is displayed on the drop-down buuton.
[Browsable(true)]
public virtual bool ShowArrow { get; set; }Gets or sets the vector image that is displayed on a button element.
public RadSvgImage SvgImage { get; set; }Gets or sets the alignment of text content on the drawing surface.
public virtual ContentAlignment TextAlignment { get; set; }Gets or sets the position of text and image relative to each other.
public virtual TextImageRelation TextImageRelation { get; set; }public override string ToolTipText { get; set; }Overrides:
Methods
Called by the element when constructed. Allows inheritors to build the element tree.
protected override void CreateChildElements()Overrides:
Releases managed resources used by this element.
protected override void DisposeManagedResources()Overrides:
Hides the drop down menu.
public virtual void HideDropDown()Initializes the fields of this instance with their default values.
protected override void InitializeFields()Overrides:
Maps a style property to another property. This method is used to map corresponding properties of LightVisualElement instances and BasePrimitive instances.
public override RadProperty MapStyleProperty(RadProperty propertyToMap, string settingType)An instance of the RadProperty class that represents the property to map.
settingTypestringReturns:An instance of the RadProperty class which represents the mapped property. If no property is found, the method returns null
Overrides:
Determines whether the event is passed up in the control hierarchy.
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)Overrides:
Raises the DropDownClosed event.
Fires when the drop-down of the button is about to close.
protected virtual void OnDropDownClosing(RadPopupClosingEventArgs args)An instance of the RadPopupClosingEventArgs class that contains information about the event.
Raises the DropDownOpened event.
Raises the DropDownOpening event.
Raises the KeyDown event.
protected override void OnKeyDown(KeyEventArgs e)The key event arguments.
Overrides:
Raises the KeyUp event.
protected override void OnKeyUp(KeyEventArgs e)The key event arguments.
Overrides:
Called when a mouse button is released over the item.
protected override void OnMouseUp(MouseEventArgs e)The mouse event arguments.
Overrides:
Called when a property value has changed, handling item-specific property change logic including text, visual state, and animation properties.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The property changed event arguments.
Overrides:
Determines whether the property defined by the provided property descriptor should be serialized.
public override bool? ShouldSerializeProperty(PropertyDescriptor property)bool?
Overrides:
Shows the drop down menu.
public virtual void ShowDropDown()Shows the drop down menu at given location
public virtual void ShowDropDown(Point location)The upper left corner of the drop down in screen coordinates
protected virtual void ShowDropDownOnClick()Events
Occurs when the drop-down window has closed.
[Browsable(true)]
public event EventHandler DropDownClosedOccurs when the drop-down window is about to close.
[Browsable(true)]
public event RadPopupClosingEventHandler DropDownClosingOccurs when the drop-down has opened.
[Browsable(true)]
public event EventHandler DropDownOpenedOccurs when the drop-down is opening.
[Browsable(true)]
public event CancelEventHandler DropDownOpening