New to Telerik UI for WPFStart a free 30-day trial

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:

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

Initializes a new instance of the RadRibbonRadioButton class.

C#
public RadRibbonRadioButton()

Fields

CollapseToMediumProperty

DependencyProperty

Identifies the CollapseToMedium property.

C#
public static readonly DependencyProperty CollapseToMediumProperty

CollapseToSmallProperty

DependencyProperty

Identifies the CollapseToSmall property.

C#
public static readonly DependencyProperty CollapseToSmallProperty

CurrentSizeProperty

DependencyProperty

Identifies the CurrentSize property.

C#
public static readonly DependencyProperty CurrentSizeProperty

IsAutoSizeProperty

DependencyProperty

Identifies the IsAutoSize property.

C#
public static readonly DependencyProperty IsAutoSizeProperty

LargeImageProperty

DependencyProperty

Identifies the LargeImage property.

C#
public static readonly DependencyProperty LargeImageProperty

SizeProperty

DependencyProperty

Identifies the Size property.

C#
public static readonly DependencyProperty SizeProperty

SmallImageProperty

DependencyProperty

Identifies the SmallImage property.

C#
public static readonly DependencyProperty SmallImageProperty

TextProperty

DependencyProperty

Identifies the Text property.

C#
public static readonly DependencyProperty TextProperty

TextRow1Property

DependencyProperty

Identifies the TextRow1 property.

C#
public static readonly DependencyProperty TextRow1Property

TextRow2Property

DependencyProperty

Identifies the TextRow2 property.

C#
public static readonly DependencyProperty TextRow2Property

Properties

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

C#
public CollapseThreshold CollapseToMedium { get; set; }

Implements: IRibbonButton.CollapseToMedium

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

C#
public CollapseThreshold CollapseToSmall { get; set; }

Implements: IRibbonButton.CollapseToSmall

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

C#
public ButtonSize CurrentSize { get; }

Implements: IRibbonButton.CurrentSize

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

C#
public bool IsAutoSize { get; set; }

LargeImage

ImageSource

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

C#
public ImageSource LargeImage { get; set; }

Implements: IRibbonButton.LargeImage

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

C#
public ButtonSize Size { get; set; }

Implements: IRibbonButton.Size

SmallImage

ImageSource

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

C#
public ImageSource SmallImage { get; set; }

Implements: IRibbonButton.SmallImage

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

C#
public string Text { get; set; }

Implements: IRibbonButton.Text

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

C#
public string TextRow1 { get; }

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

C#
public string TextRow2 { get; }

Methods

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

C#
public override void OnApplyTemplate()

Overrides: RadRadioButton.OnApplyTemplate()

Creates a RadRadioButtonAutomationPeer.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

Overrides: RadRadioButton.OnCreateAutomationPeer()

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

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

The RoutedEventArgs that contains the event data.

Overrides: RadRadioButton.OnInitialized(EventArgs)

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

C#
public void SetVariant(RibbonGroupVariant variant)
Parameters:variantRibbonGroupVariant

Implements: IVariantControl.SetVariant(RibbonGroupVariant)