New to Telerik UI for WinForms? Start a free 30-day trial

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:

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

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadDropDownButtonElement...

Derived Classes: BreadCrumbDropDownButtonElementOverflowDropDownButtonElementRadApplicationMenuButtonElementRadQuickAccessOverflowButtonRadRibbonBarGroupDropDownButtonElementRadSplitButtonElementThemeColorDropDownButtonElementThemeFontDropDownButtonElement...

Implements: IBindableComponentIComponentICustomTypeDescriptorIDisposableIDropDownMenuOwnerIImageElementIItemsOwnerINotifyPropertyChangedIShortcutProviderISiteProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkin...

Inherited Members RadItem.KeyDownEventRadItem.KeyPressEventRadItem.KeyUpEventRadItem.FocusCommandRadItem.ActionCommandRadItem.UseDefaultDisabledPaintPropertyRadItem.TextPropertyRadItem.TextOrientationPropertyRadItem.FlipTextPropertyRadItem.IsAddNewItemPropertyRadItem.ToolTipTextPropertyRadItem.EnableElementShadowPropertyRadItem.ShadowDepthPropertyRadItem.ShadowColorPropertyRadItem.IsPaintingRippleRadItem.EnableRippleAnimationPropertyRadItem.RippleAnimationColorPropertyRadItem.EnableFocusBorderPropertyRadItem.FocusBorderColorPropertyRadItem.FocusBorderWidthPropertyRadItem.EnableFocusBorderAnimationPropertyRadItem.EnableHighlightPropertyRadItem.HighlightColorPropertyRadItem.EnableBorderHighlightPropertyRadItem.BorderHighlightColorPropertyRadItem.BorderHighlightThicknessPropertyRadItem.VisualStatePropertyRadItem.SetOwnerCollection(RadItemOwnerCollection)RadItem.Select()RadItem.OnSelect()RadItem.Deselect()RadItem.OnDeselect()RadItem.DoKeyDown(KeyEventArgs)RadItem.DoKeyPress(KeyPressEventArgs)RadItem.DoKeyUp(KeyEventArgs)RadItem.OnKeyPress(KeyPressEventArgs)RadItem.RaiseBubbleEvent(RadElement, RoutedEventArgs)RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)RadItem.OnEnabledChanged(RadPropertyChangedEventArgs)RadItem.OnTextChanging(TextChangingEventArgs)RadItem.OnTextChanged(EventArgs)RadItem.OnTextOrientationChanged(EventArgs)RadItem.OnFlipTextChanged(EventArgs)RadItem.PaintOverride(IGraphics, Rectangle, float, SizeF, bool)RadItem.OnMouseDown(MouseEventArgs)RadItem.OnMouseMove(MouseEventArgs)RadItem.OnMouseLeave(EventArgs)RadItem.StartRippleAnimation(MouseEventArgs)RadItem.UpdateFocusBorder(bool)RadItem.ContainsText()RadItem.ProcessDialogKey(Keys)RadItem.ProcessCmdKey(ref Message, Keys)RadItem.RaiseKeyDown(KeyEventArgs)RadItem.RaiseKeyPress(KeyPressEventArgs)RadItem.RaiseKeyUp(KeyEventArgs)RadItem.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadItem.CallOnGesture(GestureEventArgs)RadItem.OnGesture(GestureEventArgs)RadItem.OnTwoFingerTapGesture(GestureEventArgs)RadItem.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadItem.OnPanGesture(PanGestureEventArgs)RadItem.OnRotateGesture(RotateGestureEventArgs)RadItem.OnZoomGesture(ZoomGestureEventArgs)RadItem.CanDragCore(Point)RadItem.GetDragContextCore()RadItem.GetDragHintCore()RadItem.ProcessDragDrop(Point, ISupportDrag)RadItem.ProcessDragOver(Point, ISupportDrag)RadItem.ProcessDragEnter(Point, ISupportDrag)RadItem.ProcessDragLeave(Point, ISupportDrag)RadItem.UpdateOnShortcutsChanged()RadItem.CanHandleShortcut(ShortcutEventArgs)RadItem.IsOnActiveForm(Control, bool)RadItem.SetThemeValueOverride(RadProperty, object, string)RadItem.SetThemeValueOverride(RadProperty, object, string, string)RadItem.SetThemeValueOverride(RadProperty, object, string, Type)RadItem.ResetThemeValueOverride(RadProperty)RadItem.ResetThemeValueOverride(RadProperty, string)RadItem.ResetThemeValueOverrides()RadItem.GetAvailableVisualStates()RadItem.ShouldFallbackToDefaultTheme()RadItem.UseDefaultDisabledPaintRadItem.TextOrientationRadItem.FlipTextRadItem.CanHaveOwnStyleRadItem.TextRadItem.SelectableRadItem.DefaultAutoToolTipRadItem.ShouldHandleMouseInputRadItem.KeyTipRadItem.ParentItemRadItem.ShortcutsHandlerRadItem.EnableElementShadowRadItem.ShadowDepthRadItem.ShadowColorRadItem.EnableRippleAnimationRadItem.RippleAnimationColorRadItem.EnableFocusBorderRadItem.FocusBorderColorRadItem.FocusBorderWidthRadItem.EnableFocusBorderAnimationRadItem.EnableHighlightRadItem.HighlightColorRadItem.EnableBorderHighlightRadItem.BorderHighlightColorRadItem.BorderHighlightThicknessRadItem.MnemonicTextRadItem.ThemeRoleRadItem.VisualStateRadItem.StateManagerRadItem.AllowDragRadItem.AllowDropRadItem.ShortcutsRadItem.AccessibleDescriptionRadItem.AccessibleNameRadItem.AccessibleRoleRadItem.TextChangingRadItem.TextChangedRadItem.TextOrientationChangedRadItem.FlipTextChangedRadItem.QueryAccessibilityHelpRadItem.KeyDownRadItem.KeyPressRadItem.KeyUpRadItem.ZoomGestureRadItem.RotateGestureRadItem.PanGestureRadItem.TwoFingerTapGestureRadItem.PressAndTapGestureRadComponentElement.ToString()RadComponentElement.GetService(Type)RadComponentElement.CanRaiseEventsRadComponentElement.ContainerRadComponentElement.DesignModeRadComponentElement.SiteRadComponentElement.DataBindingsVisualElement.DefaultSizePropertyVisualElement.ForeColorPropertyVisualElement.BackColorPropertyVisualElement.FontPropertyVisualElement.SmoothingModePropertyVisualElement.OpacityPropertyVisualElement.CustomFontPropertyVisualElement.CustomFontSizePropertyVisualElement.CustomFontStylePropertyVisualElement.OnFontChanged(EventArgs)VisualElement.PaintElement(IGraphics, float, SizeF)VisualElement.PaintChildren(IGraphics, Rectangle, float, SizeF, bool)VisualElement.PrePaintElement(IGraphics)VisualElement.PostPaintElement(IGraphics)VisualElement.GetScaledFont(float)VisualElement.GetScaledFont(float, Font)VisualElement.DefaultSizeVisualElement.ForeColorVisualElement.BackColorVisualElement.FontVisualElement.CustomFontVisualElement.CustomFontSizeVisualElement.CustomFontStyleVisualElement.SmoothingModeVisualElement.OpacityVisualElement.FontChangedRadElement.BoundsPropertyRadElement.BorderThicknessPropertyRadElement.PaddingPropertyRadElement.MarginPropertyRadElement.AlignmentPropertyRadElement.AutoSizeModePropertyRadElement.FitToSizeModePropertyRadElement.MinSizePropertyRadElement.EnabledPropertyRadElement.CanFocusPropertyRadElement.IsItemFocusedPropertyRadElement.IsFocusedPropertyRadElement.IsMouseOverPropertyRadElement.IsMouseOverElementPropertyRadElement.IsMouseDownPropertyRadElement.ShouldPaintPropertyRadElement.VisibilityPropertyRadElement.NamePropertyRadElement.ClassPropertyRadElement.ClipDrawingPropertyRadElement.ShapePropertyRadElement.MouseClickedEventRadElement.MouseDoubleClickedEventRadElement.MouseDownEventRadElement.MouseUpEventRadElement.MouseWheelEventRadElement.ChildElementAddedEventRadElement.ParentChangedEventRadElement.BoundsChangedEventRadElement.VisibilityChangingEventRadElement.EnabledChangedEventRadElement.ControlChangedEventRadElement.BackgroundShapePropertyRadElement.BackgroundShapePaintModePropertyRadElement.ContainsFocusPropertyRadElement.ContainsMousePropertyRadElement.MaxSizePropertyRadElement.RightToLeftPropertyRadElement.AutoSizePropertyRadElement.ZIndexPropertyRadElement.AngleTransformPropertyRadElement.ScaleTransformPropertyRadElement.PositionOffsetPropertyRadElement.TagPropertyRadElement.StretchHorizontallyPropertyRadElement.StretchVerticallyPropertyRadElement.UseCompatibleTextRenderingPropertyRadElement.ClickModePropertyRadElement.styleVersionRadElement.paintSystemSkinRadElement.SetPropertyValueCommandRadElement.GetPropertyValueCommandRadElement.StylePropertyRadElement.CallCreateChildElements()RadElement.SuspendReferenceUpdate()RadElement.ResumeReferenceUpdate()RadElement.OnLoad(bool)RadElement.LoadCore()RadElement.OnLoaded()RadElement.OnUnload(ComponentThemableElementTree, bool)RadElement.UnloadCore(ComponentThemableElementTree)RadElement.OnUnloaded(ComponentThemableElementTree)RadElement.OnElementTreeChanged(ComponentThemableElementTree)RadElement.OnBeginDispose()RadElement.SetParent(RadElement)RadElement.OnParentChanged(RadElement)RadElement.UpdateReferences(ComponentThemableElementTree, bool, bool)RadElement.ResetLayout(bool)RadElement.HasInvisibleAncestor()RadElement.ResetLayoutCore()RadElement.InvalidateArrange()RadElement.InvalidateArrange(bool)RadElement.InvalidateMeasure()RadElement.InvalidateMeasure(bool)RadElement.UpdateLayout()RadElement.SuspendLayout()RadElement.SuspendLayout(bool)RadElement.ResumeLayout(bool)RadElement.ResumeLayout(bool, bool)RadElement.Arrange(RectangleF)RadElement.Measure(SizeF)RadElement.SetBounds(Rectangle)RadElement.SetBounds(int, int, int, int)RadElement.GetBoundingRectangle(Size)RadElement.GetBoundingRectangle(Rectangle)RadElement.GetDesiredSize(bool)RadElement.PointToScreen(Point)RadElement.PointFromScreen(Point)RadElement.PointToControl(Point)RadElement.PointFromControl(Point)RadElement.LocationToControl()RadElement.RectangleToScreen(Rectangle)RadElement.HitTest(Point)RadElement.OnRenderSizeChanged(SizeChangedInfo)RadElement.OnChildDesiredSizeChanged(RadElement)RadElement.OnLayoutPropertyChanged(RadPropertyChangedEventArgs)RadElement.ArrangeCore(RectangleF)RadElement.MeasureCore(SizeF)RadElement.ShouldArrangeChild(RadElement)RadElement.ArrangeOverride(SizeF)RadElement.MeasureOverride(SizeF)RadElement.ShouldMeasureChild(RadElement)RadElement.MeasureChildren(SizeF)RadElement.GetArrangeRect(RectangleF)RadElement.CanExecuteLayoutOperation()RadElement.CalcLayoutOffset(PointF)RadElement.LockBounds()RadElement.UnlockBounds()RadElement.SetBoundsCore(Rectangle)RadElement.IsInValidState(bool)RadElement.Invalidate()RadElement.Invalidate(bool)RadElement.GetInvalidateBounds()RadElement.NotifyInvalidate(RadElement)RadElement.OnTransformationInvalidated()RadElement.PerformLayoutTransformation(ref RadMatrix)RadElement.PerformPaintTransformation(ref RadMatrix)RadElement.IsInGetAsBitmap()RadElement.PaintElementSkin(IGraphics)RadElement.PaintBackgroundShape(IGraphics)RadElement.PostPaintChildren(IGraphics, Rectangle, float, SizeF)RadElement.PaintChild(RadElement, IGraphics, Rectangle, float, SizeF, bool)RadElement.PaintShadow(RadElement, IGraphics)RadElement.PaintShadowCore(Graphics, Rectangle, RadItem)RadElement.GetShadowRect(ref Rectangle, int)RadElement.PaintFocusCues(IGraphics, Rectangle)RadElement.GetAsBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Rectangle, Brush, float, SizeF)RadElement.GetAsBitmapEx(Color, float, SizeF)RadElement.GetAsBitmapEx(Brush, float, SizeF)RadElement.GetAsBitmap(Brush, float, SizeF)RadElement.IsInVisibleClipBounds(Rectangle)RadElement.SetClipping(Graphics)RadElement.GetClipRect()RadElement.ShouldPaintChild(RadElement)RadElement.GetFocusRect()RadElement.GetCurrentShape()RadElement.GetPaintRectangle(float, float, SizeF)RadElement.GetPatchedRect(RectangleF, float, SizeF)RadElement.GetXPVisualStyle()RadElement.GetVistaVisualStyle()RadElement.InitializeSystemSkinPaint()RadElement.UnitializeSystemSkinPaint()RadElement.GetSystemSkinPaintBounds()RadElement.OnUseSystemSkinChanged(EventArgs)RadElement.ShouldPaintSystemSkin()RadElement.ComposeShouldPaintSystemSkin()RadElement.GetStylablePropertiesFilter()RadElement.ResetStyleSettings(bool)RadElement.ResetStyleSettings(bool, RadProperty)RadElement.ProcessBehaviors(RadPropertyChangedEventArgs)RadElement.AddBehavior(PropertyChangeBehavior)RadElement.GetBehaviors()RadElement.RemoveBehavior(PropertyChangeBehavior)RadElement.ClearBehaviors()RadElement.AddRangeBehavior(PropertyChangeBehaviorCollection)RadElement.SetThemeApplied(bool)RadElement.OnStyleChanged(RadPropertyChangedEventArgs)RadElement.UnapplyStyle()RadElement.RemoveRangeBehaviors(PropertyChangeBehaviorCollection)RadElement.RemoveBehaviors(PropertyChangeBehavior)RadElement.RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection)RadElement.GetThemeEffectiveType()RadElement.GetChildrenByType(Type)RadElement.GetChildrenByBaseType(Type)RadElement.FindAncestorByThemeEffectiveType(Type)RadElement.FindAncestor<T>()RadElement.IsAncestorOf(RadElement)RadElement.FindDescendant<T>()RadElement.FindDescendant(Predicate<RadElement>)RadElement.FindDescendant(Type)RadElement.EnumDescendants(TreeTraversalMode)RadElement.EnumDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.EnumDescendants(Filter, TreeTraversalMode)RadElement.GetDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.GetDescendants(Filter, TreeTraversalMode)RadElement.GetAncestors(Filter)RadElement.GetAncestors(Predicate<RadElement>)RadElement.RaiseRoutedEvent(RadElement, RoutedEventArgs)RadElement.RaiseTunnelEvent(RadElement, RoutedEventArgs)RadElement.OnTunnelEvent(RadElement, RoutedEventArgs)RadElement.IsEventInProcess(RaisedRoutedEvent)RadElement.RegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, string)RadElement.GetRegisterRoutedEvent(string)RadElement.OnChildrenChanged(RadElement, ItemsChangeOperation)RadElement.GetChildren(ChildrenListOptions)RadElement.SendToBack()RadElement.BringToFront()RadElement.IsChildOf(RadElement)RadElement.Focus()RadElement.Focus(bool)RadElement.SetFocusPropertySafe(bool)RadElement.KillFocus()RadElement.OnCLREventsRise(RoutedEventArgs)RadElement.OnMouseHover(EventArgs)RadElement.OnParentEnabledChanged(RadPropertyChangedEventArgs)RadElement.OnLostMouseCapture(MouseEventArgs)RadElement.OnClick(EventArgs)RadElement.OnDoubleClick(EventArgs)RadElement.OnMouseEnter(EventArgs)RadElement.PerformClick()RadElement.OnMouseWheel(MouseEventArgs)RadElement.DoMouseWheel(MouseEventArgs)RadElement.DoDoubleClick(EventArgs)RadElement.IsInputKey(InputKeyEventArgs)RadElement.MouseEventArgsFromControl(MouseEventArgs)RadElement.DoMouseDown(MouseEventArgs)RadElement.DoMouseUp(MouseEventArgs)RadElement.DoMouseMove(MouseEventArgs)RadElement.ShowScreenTip(ScreenTipNeededEventArgs)RadElement.HideScreenTip()RadElement.DoMouseHover(EventArgs)RadElement.OnShowScreenTip(ComponentInputBehavior)RadElement.RaiseClick(EventArgs)RadElement.RaiseDoubleClick(EventArgs)RadElement.RaiseMouseWheel(MouseEventArgs)RadElement.UpdateContainsFocus(bool)RadElement.DoMouseEnter(EventArgs)RadElement.DoMouseLeave(EventArgs)RadElement.GetValue(RadProperty)RadElement.AddStylePropertySetting(IPropertySetting)RadElement.SetValueCore(RadPropertyValue, object, object, ValueSource)RadElement.NotifyChildren(RadPropertyChangedEventArgs)RadElement.OnBoundsChanged(RadPropertyChangedEventArgs)RadElement.OnLocationChanged(RadPropertyChangedEventArgs)RadElement.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadElement.CanRaisePropertyChangeNotifications(RadPropertyValue)RadElement.IsPropertyCancelable(RadPropertyMetadata)RadElement.OnParentPropertyChanged(RadPropertyChangedEventArgs)RadElement.PerformDispose(bool)RadElement.DisposeChildren()RadElement.GetStylableChildrenHierarchy()RadElement.GetStylableChildren()RadElement.GetClientRectangle(SizeF)RadElement.GetBorderThickness(BorderPrimitive)RadElement.DpiScaleChanged(SizeF)RadElement.ElementStateRadElement.DesiredSizeRadElement.IsLayoutSuspendedRadElement.BoundingRectangleRadElement.ControlBoundingRectangleRadElement.BypassLayoutPoliciesRadElement.IsArrangeValidRadElement.IsMeasureValidRadElement.TreeLevelRadElement.TransformRadElement.TotalTransformRadElement.ShouldPaintUsingParentShapeRadElement.UseSystemSkinRadElement.PropagateStyleToChildrenRadElement.ThemeEffectiveTypeRadElement.ElementTreeRadElement.ChildrenRadElement.ChildrenHierarchyRadElement.ParentRadElement.RoutedEventBehaviorsRadElement.LayoutableChildrenCountRadElement.ContainsFocusRadElement.NotifyParentOnMouseInputRadElement.IsAbleToRespondToMouseEventsRadElement.AutoSizeRadElement.BoundsRadElement.LocationRadElement.SizeRadElement.BorderThicknessRadElement.PaddingRadElement.MarginRadElement.AlignmentRadElement.AutoSizeModeRadElement.FitToSizeModeRadElement.EnabledRadElement.CanFocusRadElement.IsFocusedRadElement.IsMouseOverRadElement.IsMouseOverElementRadElement.IsMouseDownRadElement.InvalidateChildrenOnChildChangedRadElement.ShouldPaintRadElement.VisibilityRadElement.IsElementVisibleRadElement.NameRadElement.ClassRadElement.ClipDrawingRadElement.ShapeRadElement.MinSizeRadElement.MaxSizeRadElement.ZIndexRadElement.RightToLeftRadElement.UseCompatibleTextRenderingRadElement.BackgroundShapeRadElement.BackgroundShapePaintModeRadElement.ContainsMouseRadElement.CaptureRadElement.ScaleTransformRadElement.AngleTransformRadElement.PositionOffsetRadElement.SerializePropertiesRadElement.SerializeElementRadElement.SerializeChildrenRadElement.RenderingMaxFramerateRadElement.IsThemeAppliedRadElement.ShouldApplyThemeRadElement.UseCenteredAngleTransformRadElement.TagRadElement.StretchHorizontallyRadElement.StretchVerticallyRadElement.ClickModeRadElement.DoubleClickEnabledRadElement.CaptureOnMouseDownRadElement.IsItemHoveredRadElement.StyleRadElement.ScreenTipRadElement.AutoNumberKeyTipRadElement.DpiScaleFactorRadElement.LayoutUpdatedRadElement.MouseHoverRadElement.MouseMoveRadElement.MouseDownRadElement.MouseUpRadElement.ClickRadElement.DoubleClickRadElement.MouseEnterRadElement.MouseWheelRadElement.EnabledChangedRadElement.MouseLeaveRadElement.ChildrenChangedRadElement.LostMouseCaptureRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnNotifyPropertyChanged(string)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

Initializes a new instance of the DropDownButtonElement class.

C#
public RadDropDownButtonElement()

Fields

Identifies how the action button combines its image and text.

C#
public static RadProperty DisplayStyleProperty

Identifies the alignment of the image within the action button.

C#
public static RadProperty ImageAlignmentProperty

Identifies the image-list index used to select the action button's image.

C#
public static RadProperty ImageIndexProperty

Identifies the image-list key used to select the action button's image.

C#
public static RadProperty ImageKeyProperty

Identifies the raster image property rendered in the action button.

C#
public static RadProperty ImageProperty

Identifies the property that tracks whether the drop-down menu is open.

C#
public static RadProperty IsDropDownShownProperty

Identifies the pressed-state property used to render the button's active input state.

C#
public static RadProperty IsPressedProperty

Hosts the action and arrow buttons and provides the layout surface used by derived button elements.

C#
protected DropDownEditorLayoutPanel layoutPanel

Maps image-primitive style properties to the corresponding button-item properties used by this element.

C#
public static Dictionary<RadProperty, RadProperty> mappedStyleProperties

Stores the popup menu owned by this element; derived elements can use it to customize popup behavior.

C#
protected RadDropDownButtonPopup menu

Identifies the property that distinguishes pointer-over states for the action and arrow buttons.

C#
public static RadProperty MouseOverStateProperty

Identifies the property that controls visibility of the drop-down arrow button.

C#
public static RadProperty ShowArrowProperty

Identifies the vector image property rendered in the action button.

C#
public static RadProperty SvgImageProperty

Identifies the alignment of the action button's text.

C#
public static RadProperty TextAlignmentProperty

Identifies the layout relationship between the action button's text and image.

C#
public static RadProperty TextImageRelationProperty

Properties

Gets the action button

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

Gets the arrow button

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

Gets or sets the minimum size of the arrow button

C#
public Size ArrowButtonMinSize { get; set; }

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

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

Gets or sets whether automatic tooltip behavior is enabled for both the action and arrow buttons.

C#
public override bool AutoToolTip { get; set; }

Overrides: RadElement.AutoToolTip

Gets the border element

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

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

C#
[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.

C#
[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.

C#
public bool DropDownInheritsThemeClassName { get; set; }

Implements: IDropDownMenuOwner.DropDownInheritsThemeClassName

Gets the drop down menu

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

Gets or sets the expand arrow button

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

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

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

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

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

Implements: IImageElement.Image

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

C#
public virtual ContentAlignment ImageAlignment { get; set; }

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

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

Implements: IImageElement.ImageIndex

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

C#
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.1026.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKey { get; set; }

Implements: IImageElement.ImageKey

Gets a value indicating whether the drop down is shown

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

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

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

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

C#
[RadEditItemsAction]
public RadItemOwnerCollection Items { get; }

Implements: IItemsOwner.Items

Gets the layout panel that arranges the action and arrow buttons and can host derived elements such as a split-button separator.

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

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

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

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

C#
public RadSvgImage SvgImage { get; set; }

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

C#
public virtual ContentAlignment TextAlignment { get; set; }

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

C#
public virtual TextImageRelation TextImageRelation { get; set; }

Gets or sets the tooltip text and applies it to both the action and arrow buttons.

C#
public override string ToolTipText { get; set; }

Overrides: RadItem.ToolTipText

Methods

Creates the action and arrow buttons, binds their display properties, and places them in the shared layout.

C#
protected override void CreateChildElements()

Overrides: RadElement.CreateChildElements()

Creates the popup menu owned by this element.

C#
protected virtual RadDropDownButtonPopup CreateDropDown()
Returns:

RadDropDownButtonPopup

A popup associated with this element, initialized with the control's image list when the element is attached to a valid tree.

Disposes the popup owned by this element before releasing the base element's managed resources.

C#
protected override void DisposeManagedResources()

Overrides: RadItem.DisposeManagedResources()

Raises the click behavior inherited from RadItem and then invokes ShowDropDownOnClick().

C#
protected override void DoClick(EventArgs e)
Parameters:eEventArgs

The event data associated with the click.

Overrides: RadElement.DoClick(EventArgs)

Gets the design-time site of the control containing this element, if the element is attached to one.

C#
public ISite GetSite()
Returns:

ISite

The containing control's site, or null when no sited control is available.

Implements: ISiteProvider.GetSite()

Hides the drop down menu.

C#
public virtual void HideDropDown()

Assigns the theme role used to resolve this element's visual style.

C#
protected override void InitializeFields()

Overrides: RadItem.InitializeFields()

Redirects image style properties to the corresponding RadButtonItem properties.

C#
public override RadProperty MapStyleProperty(RadProperty propertyToMap, string settingType)
Parameters:propertyToMapRadProperty

The property requested by the style.

settingTypestring

The style setting type passed to the base implementation when no mapping exists.

Returns:

RadProperty

The mapped property, or the result returned by the base implementation.

Overrides: RadElement.MapStyleProperty(RadProperty, string)

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

C#
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElementargsRoutedEventArgs

Overrides: RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)

Raises the DropDownClosed event.

C#
protected virtual void OnDropDownClosed(EventArgs e)
Parameters:eEventArgs

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

C#
protected virtual void OnDropDownClosing(RadPopupClosingEventArgs args)
Parameters:argsRadPopupClosingEventArgs

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

Raises the DropDownOpened event.

C#
protected virtual void OnDropDownOpened(EventArgs e)
Parameters:eEventArgs

Raises the DropDownOpening event.

C#
protected virtual void OnDropDownOpening(CancelEventArgs e)
Parameters:eCancelEventArgs

Starts the keyboard pressed state for Space and invokes the button action with Enter when the menu is closed.

C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs

Key data identifying the key pressed.

Overrides: RadItem.OnKeyDown(KeyEventArgs)

Invokes the button action when Space is released and clears the pressed state even if the click handler fails.

C#
protected override void OnKeyUp(KeyEventArgs e)
Parameters:eKeyEventArgs

Key data identifying the key released.

Overrides: RadItem.OnKeyUp(KeyEventArgs)

Notifies the nearest ancestor item collection that this element was clicked after processing the mouse release.

C#
protected override void OnMouseUp(MouseEventArgs e)
Parameters:eMouseEventArgs

Mouse data forwarded to the base implementation.

Overrides: RadItem.OnMouseUp(MouseEventArgs)

Keeps child state, arrow visibility, and element shapes synchronized with relevant property changes.

C#
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

Details of the property change.

Overrides: RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Handles designer serialization of SvgImageXml; other properties use the base serialization rules.

C#
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters:propertyPropertyDescriptor

The property whose serialization status is being queried.

Returns:

bool?

For SvgImageXml, true only when an image is present and the value is local or locally bound; otherwise, false. For other properties, the result returned by the base implementation.

Overrides: RadItem.ShouldSerializeProperty(PropertyDescriptor)

Shows the drop down menu.

C#
public virtual void ShowDropDown()

Shows the drop down menu at given location

C#
public virtual void ShowDropDown(Point location)
Parameters:locationPoint

The upper left corner of the drop down in screen coordinates

Shows the drop-down menu after a click; derived elements can override this hook to change that behavior.

C#
protected virtual void ShowDropDownOnClick()

Events

Occurs when the drop-down window has closed.

C#
[Browsable(true)]
public event EventHandler DropDownClosed

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

C#
[Browsable(true)]
public event RadPopupClosingEventHandler DropDownClosing

Occurs when the drop-down has opened.

C#
[Browsable(true)]
public event EventHandler DropDownOpened

Occurs when the drop-down is opening.

C#
[Browsable(true)]
public event CancelEventHandler DropDownOpening