Back to all docs
API Reference / Telerik.Windows.Controls / RadRibbonDropDownButton

Class
RadRibbonDropDownButton

Represents a button in a RadRibbonView that displays a dropdown menu, allowing for the selection of items in a navigation-style interface. This control combines button functionalities with additional properties to manage appearance, sizing, image, and text layout for different states (small, medium, and large). It supports features such as automatic sizing, customizable collapse thresholds, and image handling. The button triggers popup interactions with child controls and handles visual state changes dynamically based on its properties.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.RibbonView.dll

Syntax:
cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadRibbonDropDownButton : RadDropDownButton, IDisposable, IRibbonButton, IVariantControl

Inheritance: objectRadButtonRadDropDownButtonRadRibbonDropDownButton

Derived Classes: RadRibbonApplicationDropDownButton

Implements: IDisposableIRibbonButtonIVariantControl

Inherited Members RadDropDownButton.DropDownIndicatorVisibilityPropertyRadDropDownButton.AutoOpenDelayPropertyRadDropDownButton.CloseOnEscapePropertyRadDropDownButton.CloseOnEnterPropertyRadDropDownButton.DropDownContentPropertyRadDropDownButton.DropDownWidthPropertyRadDropDownButton.DropDownHeightPropertyRadDropDownButton.DropDownMinWidthPropertyRadDropDownButton.DropDownMinHeightPropertyRadDropDownButton.DropDownMaxWidthPropertyRadDropDownButton.DropDownMaxHeightPropertyRadDropDownButton.IsOpenPropertyRadDropDownButton.KeepOpenPropertyRadDropDownButton.DropDownButtonPositionPropertyRadDropDownButton.DropDownPlacementPropertyRadDropDownButton.PopupPlacementTargetPropertyRadDropDownButton.DropDownContentTemplatePropertyRadDropDownButton.DropDownContentTemplateSelectorPropertyRadDropDownButton.DropDownClosedEventRadDropDownButton.DropDownOpenedEventRadDropDownButton.DropDownOpeningEventRadDropDownButton.CloseOnPopupMouseLeftButtonUpPropertyRadDropDownButton.PopupAnimationPropertyRadDropDownButton.Finalize()RadDropDownButton.Dispose()RadDropDownButton.OnMouseWheel(MouseWheelEventArgs)RadDropDownButton.OnHover()RadDropDownButton.OnActivate()RadDropDownButton.OnClick()RadDropDownButton.OnMouseLeftButtonDown(MouseButtonEventArgs)RadDropDownButton.OnMouseLeftButtonUp(MouseButtonEventArgs)RadDropDownButton.OnLostKeyboardFocus(KeyboardFocusChangedEventArgs)RadDropDownButton.ApplyPopupPlacement()RadDropDownButton.OnDropDownContentChanged(object, object)RadDropDownButton.OnDropDownPlacementChanged(DataTemplate, DataTemplate)RadDropDownButton.OnDropDownContentTemplateChanged(DataTemplate, DataTemplate)RadDropDownButton.OnDropDownContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)RadDropDownButton.OnIsOpenChanged(bool, bool)RadDropDownButton.IsOpenRadDropDownButton.KeepOpenRadDropDownButton.DropDownIndicatorVisibilityRadDropDownButton.AutoOpenDelayRadDropDownButton.CloseOnEscapeRadDropDownButton.CloseOnEnterRadDropDownButton.DropDownContentRadDropDownButton.DropDownButtonPositionRadDropDownButton.DropDownPlacementRadDropDownButton.DropDownContentTemplateRadDropDownButton.DropDownContentTemplateSelectorRadDropDownButton.DropDownWidthRadDropDownButton.DropDownHeightRadDropDownButton.DropDownMinWidthRadDropDownButton.DropDownMinHeightRadDropDownButton.DropDownMaxWidthRadDropDownButton.DropDownMaxHeightRadDropDownButton.CloseOnPopupMouseLeftButtonUpRadDropDownButton.PopupPlacementTargetRadDropDownButton.PopupAnimationRadDropDownButton.DropDownClosedRadDropDownButton.DropDownOpenedRadDropDownButton.DropDownOpeningRadButton.HoverDelayPropertyRadButton.CornerRadiusPropertyRadButton.IsBackgroundVisiblePropertyRadButton.ActivateEventRadButton.HoverEventRadButton.OnLostFocus(RoutedEventArgs)RadButton.OnGotFocus(RoutedEventArgs)RadButton.OnMouseEnter(MouseEventArgs)RadButton.OnMouseLeave(MouseEventArgs)RadButton.OnMouseMove(MouseEventArgs)RadButton.OnIsPressedChanged(DependencyPropertyChangedEventArgs)RadButton.HoverDelayRadButton.CornerRadiusRadButton.IsBackgroundVisibleRadButton.ActivateRadButton.Hover

Constructors

RadRibbonDropDownButton()

Initializes a new instance of the RadRibbonDropDownButton class.

Declaration

cs-api-definition
public RadRibbonDropDownButton()

Fields

CollapseToMediumProperty

Identifies the CollapseToMedium property.

Declaration

cs-api-definition
public static readonly DependencyProperty CollapseToMediumProperty

Field Value

DependencyProperty

CollapseToSmallProperty

Identifies the CollapseToSmall property.

Declaration

cs-api-definition
public static readonly DependencyProperty CollapseToSmallProperty

Field Value

DependencyProperty

CurrentSizeProperty

Identifies the CurrentSize property.

Declaration

cs-api-definition
public static readonly DependencyProperty CurrentSizeProperty

Field Value

DependencyProperty

IsAutoSizeProperty

Identifies the IsAutoSize property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsAutoSizeProperty

Field Value

DependencyProperty

LargeImageProperty

Identifies the LargeImage property.

Declaration

cs-api-definition
public static readonly DependencyProperty LargeImageProperty

Field Value

DependencyProperty

SizeProperty

Identifies the Size property.

Declaration

cs-api-definition
public static readonly DependencyProperty SizeProperty

Field Value

DependencyProperty

SmallImageProperty

Identifies the SmallImage property.

Declaration

cs-api-definition
public static readonly DependencyProperty SmallImageProperty

Field Value

DependencyProperty

SplitTextProperty

Identifies the SplitText property.

Declaration

cs-api-definition
public static readonly DependencyProperty SplitTextProperty

Field Value

DependencyProperty

TextProperty

Identifies the Text property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextProperty

Field Value

DependencyProperty

TextRow1Property

Identifies the TextRow1 property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextRow1Property

Field Value

DependencyProperty

TextRow2Property

Identifies the TextRow2 property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextRow2Property

Field Value

DependencyProperty

Properties

CollapseToMedium

Get/Set the guidance about button's resize to the Medium size. This is a dependency property.

Declaration

cs-api-definition
public CollapseThreshold CollapseToMedium { get; set; }

Property Value

CollapseThreshold

Implements IRibbonButton.CollapseToMedium

CollapseToSmall

Get/Set the guidance about button's resize to the Small size. This is a dependency property.

Declaration

cs-api-definition
public CollapseThreshold CollapseToSmall { get; set; }

Property Value

CollapseThreshold

Implements IRibbonButton.CollapseToSmall

CurrentSize

Get/Set the current State-size of the button. This is a dependency property.

Declaration

cs-api-definition
public ButtonSize CurrentSize { get; }

Property Value

ButtonSize

Implements IRibbonButton.CurrentSize

IsAutoSize

Get/Set the permission to resize the Image according to the RibbonView guidance. This is a dependency property.

Declaration

cs-api-definition
public bool IsAutoSize { get; set; }

Property Value

bool

LargeImage

Get/Set the LargeImage that is shown in Large button state. This is a dependency property.

Declaration

cs-api-definition
public ImageSource LargeImage { get; set; }

Property Value

ImageSource

Implements IRibbonButton.LargeImage

Size

Get/Set the button initial size. In fact this is the max-size that the button can implement. This is a dependency property.

Declaration

cs-api-definition
public ButtonSize Size { get; set; }

Property Value

ButtonSize

Implements IRibbonButton.Size

SmallImage

Get/Set the SmallImage that is shown in Medium and Small button state. This is a dependency property.

Declaration

cs-api-definition
public ImageSource SmallImage { get; set; }

Property Value

ImageSource

Implements IRibbonButton.SmallImage

SplitText

Enable/disable the Text splitting for the Large-sized button. This is a dependency property.

Declaration

cs-api-definition
public bool SplitText { get; set; }

Property Value

bool

Text

Get/Set the Text label that is shown in Medium and Large button state. This is a dependency property.

Declaration

cs-api-definition
public string Text { get; set; }

Property Value

string

Implements IRibbonButton.Text

TextRow1

Get/Set the Text label that is shown in Medium and Large button state. This is a dependency property.

Declaration

cs-api-definition
public string TextRow1 { get; }

Property Value

string

TextRow2

Get/Set the Text label that is shown only in Large button state. This is a dependency property.

Declaration

cs-api-definition
public string TextRow2 { get; }

Property Value

string

Methods

ApplyDropDownButtonPosition()

Initializes the position of the DropDown indicator and correct the placement of the Popup window.

Declaration

cs-api-definition
protected override void ApplyDropDownButtonPosition()

Overrides RadDropDownButton.ApplyDropDownButtonPosition()

HidePopupOnChildItemActivated(object, RoutedEventArgs)

Hides the Popup when one of observed Children is activated.

Declaration

cs-api-definition
protected void HidePopupOnChildItemActivated(object sender, RoutedEventArgs e)

Parameters

sender

object

e

RoutedEventArgs

OnApplyTemplate()

Invoked whenever application code or internal processes (such as a rebuilding layout pass) call. .

Declaration

cs-api-definition
public override void OnApplyTemplate()

Overrides RadDropDownButton.OnApplyTemplate()

OnCreateAutomationPeer()

Creates a RadDropDownButtonAutomationPeer.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

Overrides RadDropDownButton.OnCreateAutomationPeer()

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

Overrides RadDropDownButton.OnInitialized(EventArgs)

OnKeyDown(KeyEventArgs)

Called before the event occurs.

Declaration

cs-api-definition
protected override void OnKeyDown(KeyEventArgs e)

Parameters

e

KeyEventArgs

The data for the event.

Overrides RadDropDownButton.OnKeyDown(KeyEventArgs)

SetVariant(RibbonGroupVariant)

Implements the interface for button resizing in order to follow the resize mechanism of the ribbon group.

Declaration

cs-api-definition
public void SetVariant(RibbonGroupVariant variant)

Parameters

variant

RibbonGroupVariant

Implements IVariantControl.SetVariant(RibbonGroupVariant)

In this article
DefinitionConstructorsRadRibbonDropDownButton()FieldsCollapseToMediumPropertyCollapseToSmallPropertyCurrentSizePropertyIsAutoSizePropertyLargeImagePropertySizePropertySmallImagePropertySplitTextPropertyTextPropertyTextRow1PropertyTextRow2PropertyPropertiesCollapseToMediumCollapseToSmallCurrentSizeIsAutoSizeLargeImageSizeSmallImageSplitTextTextTextRow1TextRow2MethodsApplyDropDownButtonPosition()HidePopupOnChildItemActivated(object, RoutedEventArgs)OnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)OnKeyDown(KeyEventArgs)SetVariant(RibbonGroupVariant)
Not finding the help you need?
Contact Support