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

Class
RadRibbonRadioButton

Represents a radio button designed for use in a RadRibbonView, combining image and text support with resizing capabilities. The RadRibbonRadioButton class inherits from RadRadioButton and implements the IRibbonButton and IVariantControl interfaces, enabling a flexible and visually organized way to present radio button options in a ribbon-style layout. This button includes multiple text rows, configurable images for different button sizes, and properties that allow for automatic resizing behavior to accommodate varying display requirements. The radio button's appearance can be influenced, via dependency properties, by factors such as button size, image display, and text visibility, thus creating a tailored user experience as per the application’s UI needs.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.RibbonView.dll

Syntax:
cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadRibbonRadioButton : RadRadioButton, IRibbonButton, IVariantControl

Inheritance: objectRadRadioButtonRadRibbonRadioButton

Implements: IRibbonButtonIVariantControl

Inherited Members RadRadioButton.CornerRadiusPropertyRadRadioButton.IsBackgroundVisiblePropertyRadRadioButton.ActivateEventRadRadioButton.OnActivate()RadRadioButton.OnToggle()RadRadioButton.OnMouseEnter(MouseEventArgs)RadRadioButton.OnMouseLeave(MouseEventArgs)RadRadioButton.OnMouseLeftButtonUp(MouseButtonEventArgs)RadRadioButton.OnLostFocus(RoutedEventArgs)RadRadioButton.OnGotFocus(RoutedEventArgs)RadRadioButton.CornerRadiusRadRadioButton.IsBackgroundVisibleRadRadioButton.Activate

Constructors

RadRibbonRadioButton()

Initializes a new instance of the RadRibbonRadioButton class.

Declaration

cs-api-definition
public RadRibbonRadioButton()

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

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

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

OnApplyTemplate()

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

Declaration

cs-api-definition
public override void OnApplyTemplate()

Overrides RadRadioButton.OnApplyTemplate()

OnCreateAutomationPeer()

Creates a RadRadioButtonAutomationPeer.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

Overrides RadRadioButton.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 RadRadioButton.OnInitialized(EventArgs)

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
DefinitionConstructorsRadRibbonRadioButton()FieldsCollapseToMediumPropertyCollapseToSmallPropertyCurrentSizePropertyIsAutoSizePropertyLargeImagePropertySizePropertySmallImagePropertyTextPropertyTextRow1PropertyTextRow2PropertyPropertiesCollapseToMediumCollapseToSmallCurrentSizeIsAutoSizeLargeImageSizeSmallImageTextTextRow1TextRow2MethodsOnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)SetVariant(RibbonGroupVariant)
Not finding the help you need?
Contact Support