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:
[TelerikToolboxCategory("Navigation")]
public class RadRibbonDropDownButton : RadDropDownButton, IDisposable, IRibbonButton, IVariantControlInheritance: objectRadButtonRadDropDownButtonRadRibbonDropDownButton
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadRibbonDropDownButton class.
public RadRibbonDropDownButton()Fields
CollapseToMediumProperty
DependencyProperty
Identifies the CollapseToMedium property.
public static readonly DependencyProperty CollapseToMediumPropertyCollapseToSmallProperty
DependencyProperty
Identifies the CollapseToSmall property.
public static readonly DependencyProperty CollapseToSmallPropertyCurrentSizeProperty
DependencyProperty
Identifies the CurrentSize property.
public static readonly DependencyProperty CurrentSizePropertyIsAutoSizeProperty
DependencyProperty
Identifies the IsAutoSize property.
public static readonly DependencyProperty IsAutoSizePropertyLargeImageProperty
DependencyProperty
Identifies the LargeImage property.
public static readonly DependencyProperty LargeImagePropertySizeProperty
DependencyProperty
Identifies the Size property.
public static readonly DependencyProperty SizePropertySmallImageProperty
DependencyProperty
Identifies the SmallImage property.
public static readonly DependencyProperty SmallImagePropertySplitTextProperty
DependencyProperty
Identifies the SplitText property.
public static readonly DependencyProperty SplitTextPropertyTextProperty
DependencyProperty
Identifies the Text property.
public static readonly DependencyProperty TextPropertyTextRow1Property
DependencyProperty
Identifies the TextRow1 property.
public static readonly DependencyProperty TextRow1PropertyTextRow2Property
DependencyProperty
Identifies the TextRow2 property.
public static readonly DependencyProperty TextRow2PropertyProperties
Get/Set the guidance about button's resize to the Medium size. This is a dependency property.
public CollapseThreshold CollapseToMedium { get; set; }Implements:
Get/Set the guidance about button's resize to the Small size. This is a dependency property.
public CollapseThreshold CollapseToSmall { get; set; }Implements:
Get/Set the current State-size of the button. This is a dependency property.
public ButtonSize CurrentSize { get; }Implements:
Get/Set the permission to resize the Image according to the RibbonView guidance. This is a dependency property.
public bool IsAutoSize { get; set; }LargeImage
ImageSource
Get/Set the LargeImage that is shown in Large button state. This is a dependency property.
public ImageSource LargeImage { get; set; }Implements:
Get/Set the button initial size. In fact this is the max-size that the button can implement. This is a dependency property.
public ButtonSize Size { get; set; }Implements:
SmallImage
ImageSource
Get/Set the SmallImage that is shown in Medium and Small button state. This is a dependency property.
public ImageSource SmallImage { get; set; }Implements:
Enable/disable the Text splitting for the Large-sized button. This is a dependency property.
public bool SplitText { get; set; }Get/Set the Text label that is shown in Medium and Large button state. This is a dependency property.
public string Text { get; set; }Implements:
Get/Set the Text label that is shown in Medium and Large button state. This is a dependency property.
public string TextRow1 { get; }Methods
Initializes the position of the DropDown indicator and correct the placement of the Popup window.
protected override void ApplyDropDownButtonPosition()Overrides:
Hides the Popup when one of observed Children is activated.
protected void HidePopupOnChildItemActivated(object sender, RoutedEventArgs e)Invoked whenever application code or internal processes (such as a rebuilding layout pass) call. .
public override void OnApplyTemplate()Overrides:
OnCreateAutomationPeer()
AutomationPeer
Creates a RadDropDownButtonAutomationPeer.
protected override AutomationPeer OnCreateAutomationPeer()AutomationPeer
Overrides:
Raises the event. This method is invoked whenever is set to true internally.
protected override void OnInitialized(EventArgs e)The RoutedEventArgs that contains the event data.
Overrides:
Called before the event occurs.
protected override void OnKeyDown(KeyEventArgs e)The data for the event.
Overrides:
Implements the interface for button resizing in order to follow the resize mechanism of the ribbon group.
public void SetVariant(RibbonGroupVariant variant)Implements: