Class RadDropDownButtonElement

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.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
RadDropDownButtonElement
BreadCrumbDropDownButtonElement
OverflowDropDownButtonElement
RadApplicationMenuButtonElement
RadQuickAccessOverflowButton
RadRibbonBarGroupDropDownButtonElement
RadSplitButtonElement
ThemeColorDropDownButtonElement
ThemeFontDropDownButtonElement
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[ComVisible(false)]
public class RadDropDownButtonElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IDropDownMenuOwner, ISiteProvider, IItemsOwner, IImageElement

Constructors

RadDropDownButtonElement()

Initializes a new instance of the DropDownButtonElement class.

Declaration
public RadDropDownButtonElement()

Fields

DisplayStyleProperty

Declaration
public static RadProperty DisplayStyleProperty
Field Value
RadProperty

ImageAlignmentProperty

Declaration
public static RadProperty ImageAlignmentProperty
Field Value
RadProperty

ImageIndexProperty

Declaration
public static RadProperty ImageIndexProperty
Field Value
RadProperty

ImageKeyProperty

Declaration
public static RadProperty ImageKeyProperty
Field Value
RadProperty

ImageProperty

Declaration
public static RadProperty ImageProperty
Field Value
RadProperty

IsDropDownShownProperty

Declaration
public static RadProperty IsDropDownShownProperty
Field Value
RadProperty

IsPressedProperty

Declaration
public static RadProperty IsPressedProperty
Field Value
RadProperty

layoutPanel

Declaration
protected DropDownEditorLayoutPanel layoutPanel
Field Value
DropDownEditorLayoutPanel

mappedStyleProperties

Declaration
public static Dictionary<RadProperty, RadProperty> mappedStyleProperties
Field Value
System.Collections.Generic.Dictionary<RadProperty, RadProperty>

menu

Declaration
protected RadDropDownButtonPopup menu
Field Value
RadDropDownButtonPopup

MouseOverStateProperty

Declaration
public static RadProperty MouseOverStateProperty
Field Value
RadProperty

ShowArrowProperty

Declaration
public static RadProperty ShowArrowProperty
Field Value
RadProperty

SvgImageProperty

Declaration
public static RadProperty SvgImageProperty
Field Value
RadProperty

TextAlignmentProperty

Declaration
public static RadProperty TextAlignmentProperty
Field Value
RadProperty

TextImageRelationProperty

Declaration
public static RadProperty TextImageRelationProperty
Field Value
RadProperty

Properties

ActionButton

Gets the action button

Declaration
public RadButtonElement ActionButton { get; }
Property Value
RadButtonElement

ArrowButton

Gets the arrow button

Declaration
public RadArrowButtonElement ArrowButton { get; }
Property Value
RadArrowButtonElement

ArrowButtonMinSize

Gets or sets the minimum size of the arrow button

Declaration
public Size ArrowButtonMinSize { get; set; }
Property Value
System.Drawing.Size

ArrowPosition

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

Declaration
[RadPropertyDefaultValue("ArrowPosition", typeof(DropDownEditorLayoutPanel))]
public virtual DropDownButtonArrowPosition ArrowPosition { get; set; }
Property Value
DropDownButtonArrowPosition

AutoToolTip

Declaration
public override bool AutoToolTip { get; set; }
Property Value
System.Boolean

Overrides

BorderElement

Gets the border element

Declaration
public BorderPrimitive BorderElement { get; }
Property Value
BorderPrimitive

DisplayStyle

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

Declaration
[RadPropertyDefaultValue("DisplayStyle", typeof(RadButtonItem))]
public DisplayStyle DisplayStyle { get; set; }
Property Value
DisplayStyle

DropDownDirection

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

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

DropDownInheritsThemeClassName

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
System.Boolean

Implements

DropDownMenu

Gets the drop down menu

Declaration
public RadDropDownMenu DropDownMenu { get; }
Property Value
RadDropDownMenu

ExpandArrowButton

Gets or sets the expand arrow button

Declaration
[RadDefaultValue("ExpandArrow", typeof(DropDownEditorLayoutPanel))]
public bool ExpandArrowButton { get; set; }
Property Value
System.Boolean

HasTwoColumnDropDown

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

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

Image

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

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

Implements

ImageAlignment

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

Declaration
[RadPropertyDefaultValue("ImageAlignment", typeof(RadButtonItem))]
public virtual ContentAlignment ImageAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

ImageIndex

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

Declaration
[RadPropertyDefaultValue("ImageIndex", typeof(RadButtonItem))]
public virtual int ImageIndex { get; set; }
Property Value
System.Int32

Implements

ImageKey

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

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

Implements

IsDropDownShown

Gets a value indicating whether the drop down is shown

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

IsPressed

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

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

Items

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

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

Implements

Layout

Declaration
public DropDownEditorLayoutPanel Layout { get; }
Property Value
DropDownEditorLayoutPanel

ShowArrow

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

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

SvgImage

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

Declaration
[RadPropertyDefaultValue("SvgImage", typeof(RadButtonItem))]
public RadSvgImage SvgImage { get; set; }
Property Value
RadSvgImage

SvgImageXml

Gets or sets the Svg Image as string.

Declaration
[VsbBrowsable(false)]
public string SvgImageXml { get; set; }
Property Value
System.String

TextAlignment

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

Declaration
[RadPropertyDefaultValue("TextAlignment", typeof(RadButtonItem))]
public virtual ContentAlignment TextAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

TextImageRelation

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

Declaration
[RadPropertyDefaultValue("ImageTextRelation", typeof(RadButtonItem))]
public virtual TextImageRelation TextImageRelation { get; set; }
Property Value
System.Windows.Forms.TextImageRelation

ToolTipText

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

Overrides

Methods

CreateChildElements()

Declaration
protected override void CreateChildElements()
Overrides

CreateDropDown()

Declaration
protected virtual RadDropDownButtonPopup CreateDropDown()
Returns
RadDropDownButtonPopup

DisposeManagedResources()

Declaration
protected override void DisposeManagedResources()
Overrides

DoClick(EventArgs)

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

Overrides

GetSite()

Declaration
public ISite GetSite()
Returns
System.ComponentModel.ISite

Implements

HideDropDown()

Hides the drop down menu.

Declaration
public virtual void HideDropDown()

InitializeFields()

Declaration
protected override void InitializeFields()
Overrides

MapStyleProperty(RadProperty, String)

Declaration
public override RadProperty MapStyleProperty(RadProperty propertyToMap, string settingType)
Parameters
RadProperty propertyToMap

System.String settingType

Returns
RadProperty

Overrides

OnBubbleEvent(RadElement, RoutedEventArgs)

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

Declaration
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters
RadElement sender

RoutedEventArgs args

Overrides

OnDropDownClosed(EventArgs)

Raises the DropDownClosed event.

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

OnDropDownClosing(RadPopupClosingEventArgs)

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

Declaration
protected virtual void OnDropDownClosing(RadPopupClosingEventArgs args)
Parameters
RadPopupClosingEventArgs args

An instance of the RadPopupClosingEventArgs class that contains information about the event.

OnDropDownOpened(EventArgs)

Raises the DropDownOpened event.

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

OnDropDownOpening(CancelEventArgs)

Raises the DropDownOpening event.

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

OnKeyDown(KeyEventArgs)

Declaration
protected override void OnKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

Overrides

OnKeyUp(KeyEventArgs)

Declaration
protected override void OnKeyUp(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

Overrides

OnMouseUp(MouseEventArgs)

Declaration
protected override void OnMouseUp(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

Overrides

OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides

ShouldSerializeProperty(PropertyDescriptor)

Declaration
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters
System.ComponentModel.PropertyDescriptor property

Returns
System.Nullable<System.Boolean>

Overrides

ShowDropDown()

Shows the drop down menu.

Declaration
public virtual void ShowDropDown()

ShowDropDown(Point)

Shows the drop down menu at given location

Declaration
public virtual void ShowDropDown(Point location)
Parameters
System.Drawing.Point location

The upper left corner of the drop down in screen coordinates

ShowDropDownOnClick()

Declaration
protected virtual void ShowDropDownOnClick()

Events

DropDownClosed

Occurs when the drop-down window has closed.

Declaration
public event EventHandler DropDownClosed
Event Type
System.EventHandler

DropDownClosing

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

Declaration
public event RadPopupClosingEventHandler DropDownClosing
Event Type
RadPopupClosingEventHandler

DropDownOpened

Occurs when the drop-down has opened.

Declaration
public event EventHandler DropDownOpened
Event Type
System.EventHandler

DropDownOpening

Occurs when the drop-down is opening.

Declaration
public event CancelEventHandler DropDownOpening
Event Type
System.ComponentModel.CancelEventHandler

Explicit Interface Implementations

IDropDownMenuOwner.ControlDefinesThemeForElement(RadElement)

Declaration
bool IDropDownMenuOwner.ControlDefinesThemeForElement(RadElement element)
Parameters
RadElement element

Returns
System.Boolean

Implements

Extension Methods