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

Class
RadRibbonSplitButton

Represents a split button control specifically designed for use within a ribbon interface. This class extends the functionality of the RadSplitButton to include features typical of a ribbon button, such as multi-line text support and automatic resizing based on the available space. The RadRibbonSplitButton includes properties for managing text, images (both small and large), and size, allowing for flexible customization. The control also provides functionality to manage drop-down popups and their behavior during user interactions, as well as various template parts for layout customization. The split button can display two rows of text and adjusts its visual appearance and behavior according to the current state and size. This control effectively enhances the user experience in ribbon-based applications by providing a visually appealing and easy-to-use button interface.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.RibbonView.dll

Syntax:
cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadRibbonSplitButton : RadSplitButton, ICommandSource, IDisposable, IRibbonButton, IVariantControl

Inheritance: objectRadSplitButtonRadRibbonSplitButton

Implements: ICommandSourceIDisposableIRibbonButtonIVariantControl

Inherited Members RadSplitButton.ClickEventRadSplitButton.CheckedEventRadSplitButton.UncheckedEventRadSplitButton.ActivateEventRadSplitButton.DropDownClosedEventRadSplitButton.DropDownOpenedEventRadSplitButton.DropDownOpeningEventRadSplitButton.CloseOnPopupMouseLeftButtonUpPropertyRadSplitButton.CornerRadiusPropertyRadSplitButton.ToggleCornerRadiusPropertyRadSplitButton.ButtonCornerRadiusPropertyRadSplitButton.IsBackgroundVisiblePropertyRadSplitButton.CommandParameterPropertyRadSplitButton.CommandPropertyRadSplitButton.CommandTargetPropertyRadSplitButton.DropDownIndicatorVisibilityPropertyRadSplitButton.AutoOpenDelayPropertyRadSplitButton.CloseOnEscapePropertyRadSplitButton.IsCheckedPropertyRadSplitButton.IsTogglePropertyRadSplitButton.DropDownContentPropertyRadSplitButton.DropDownWidthPropertyRadSplitButton.DropDownHeightPropertyRadSplitButton.DropDownMaxWidthPropertyRadSplitButton.DropDownMaxHeightPropertyRadSplitButton.IsOpenPropertyRadSplitButton.IsButtonPartVisiblePropertyRadSplitButton.DropDownButtonPositionPropertyRadSplitButton.DropDownPlacementPropertyRadSplitButton.DropDownContentTemplatePropertyRadSplitButton.DropDownContentTemplateSelectorPropertyRadSplitButton.TogglePartStylePropertyRadSplitButton.ButtonPartStylePropertyRadSplitButton.IsFocusedPropertyRadSplitButton.ToggleContentRotateAnglePropertyRadSplitButton.PopupAnimationPropertyRadSplitButton.Dispose()RadSplitButton.OnMouseWheel(MouseWheelEventArgs)RadSplitButton.OnActivate()RadSplitButton.OnClick()RadSplitButton.OnToggle()RadSplitButton.OnChecked()RadSplitButton.OnUnchecked()RadSplitButton.OnGotFocus(RoutedEventArgs)RadSplitButton.OnLostFocus(RoutedEventArgs)RadSplitButton.OnMouseEnter(MouseEventArgs)RadSplitButton.OnMouseLeave(MouseEventArgs)RadSplitButton.OnMouseMove(MouseEventArgs)RadSplitButton.OnDropDownContentChanged(object, object)RadSplitButton.OnDropDownContentTemplateChanged(DataTemplate, DataTemplate)RadSplitButton.OnDropDownContentTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)RadSplitButton.OnIsButtonPartVisibleChanged(bool, bool)RadSplitButton.OnDropDownPlacementChanged(PlacementMode, PlacementMode)RadSplitButton.GetToggleContentRotateAngle(DependencyObject)RadSplitButton.SetToggleContentRotateAngle(DependencyObject, double)RadSplitButton.CloseOnPopupMouseLeftButtonUpRadSplitButton.IsEnabledCoreRadSplitButton.CommandRadSplitButton.CommandParameterRadSplitButton.CommandTargetRadSplitButton.IsOpenRadSplitButton.IsFocusedRadSplitButton.IsButtonPartVisibleRadSplitButton.DropDownIndicatorVisibilityRadSplitButton.AutoOpenDelayRadSplitButton.CloseOnEscapeRadSplitButton.IsCheckedRadSplitButton.IsToggleRadSplitButton.DropDownContentRadSplitButton.DropDownButtonPositionRadSplitButton.DropDownPlacementRadSplitButton.DropDownContentTemplateRadSplitButton.DropDownContentTemplateSelectorRadSplitButton.DropDownWidthRadSplitButton.DropDownHeightRadSplitButton.DropDownMaxWidthRadSplitButton.DropDownMaxHeightRadSplitButton.TogglePartStyleRadSplitButton.ButtonPartStyleRadSplitButton.CornerRadiusRadSplitButton.ToggleCornerRadiusRadSplitButton.ButtonCornerRadiusRadSplitButton.IsBackgroundVisibleRadSplitButton.PopupAnimationRadSplitButton.ClickRadSplitButton.CheckedRadSplitButton.UncheckedRadSplitButton.ActivateRadSplitButton.DropDownClosedRadSplitButton.DropDownOpenedRadSplitButton.DropDownOpening

Constructors

RadRibbonSplitButton()

Initializes a new instance of the RadRibbonSplitButton class.

Declaration

cs-api-definition
public RadRibbonSplitButton()

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

IsTextInMiddleButtonProperty

Identifies the IsTextInMiddleButton property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsTextInMiddleButtonProperty

Field Value

DependencyProperty

KeepOpenProperty

Identifies the KeepOpen property.

Declaration

cs-api-definition
public static readonly DependencyProperty KeepOpenProperty

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

IsTextInMiddleButton

Get/Set the placement of the text in the Middle-sized button. This is a dependency property.

Declaration

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

Property Value

bool

KeepOpen

Defines the close behavior of the popup window. If True the popup will stays opened regardless its children activity.

Declaration

cs-api-definition
public bool KeepOpen { 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

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 RadSplitButton.OnApplyTemplate()

OnCreateAutomationPeer()

Creates a RadSplitButtonAutomationPeer.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

Overrides RadSplitButton.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 RadSplitButton.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 RadSplitButton.OnKeyDown(KeyEventArgs)

OnPreviewKeyDown(KeyEventArgs)

Declaration

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

Parameters

e

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
DefinitionConstructorsRadRibbonSplitButton()FieldsCollapseToMediumPropertyCollapseToSmallPropertyCurrentSizePropertyIsAutoSizePropertyIsTextInMiddleButtonPropertyKeepOpenPropertyLargeImagePropertySizePropertySmallImagePropertySplitTextPropertyTextPropertyTextRow1PropertyTextRow2PropertyPropertiesCollapseToMediumCollapseToSmallCurrentSizeIsAutoSizeIsTextInMiddleButtonKeepOpenLargeImageSizeSmallImageSplitTextTextTextRow1TextRow2MethodsHidePopupOnChildItemActivated(object, RoutedEventArgs)OnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)OnKeyDown(KeyEventArgs)OnPreviewKeyDown(KeyEventArgs)SetVariant(RibbonGroupVariant)
Not finding the help you need?
Contact Support