# Overview There is a specific set of buttons introduced with the **RadRibbonView** control. They all inherit and extend the functionality of the standard button controls i.e. **RadRibbonToggleButton** derives from **Microsoft.UI.Xaml.Controls.ToggleButton**, **RadRibbonButton** derives from **Microsoft.UI.Xaml.Controls.Button**, etc. The additional functionality which they provide allows you to easily implement MS-Office-Ribbon-like behavior in your application. This topic covers the common functionality for all ribbon buttons. > The **RadRibbonButtons** can be used outside the **RadRibbonView** control as well. The following Ribbon buttons are available: * [Ribbon Button](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-buttons/ribbonbutton) * [Ribbon ToggleButton](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-buttons/toggle-button) * [Ribbon RadioButton](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-buttons/radio-button) * [Ribbon DropDownButton](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-buttons/dropdown-button) * [Ribbon SplitButton](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-buttons/split-button) ## Button States There are three button states: #### **Figure 1: Large: Displays the large icon and the text label defined for the button** ![WinUI RadRibbonView Large: Displays the large icon and the text label defined for the button](https://www.telerik.com/winui/documentation/assets/bd4422da1b76a8bf7ad6d0a79268bc96/ribbonview_buttons_overview_large.png) #### **Figure 2: Medium: Displays the small icon and the text label defined for the button** ![WinUI RadRibbonView Medium: Displays the small icon and the text label defined for the button](https://www.telerik.com/winui/documentation/assets/5b48c5ee8f44009c0493325eb5929819/ribbonview_buttons_overview_medium.png) #### **Figure 3: Small: Displays the small icon defined for the button** ![WinUI RadRibbonView Small: Displays the small icon defined for the button](https://www.telerik.com/winui/documentation/assets/9df73963901ee9b646a0cc6240761d92/ribbonview_buttons_overview_small.png) The state of the button depends on the state of the **RadRibbonGroup** and can be controlled via the **CollapseToSmall**, **CollapseToMedium** and the **IsAutoSize** properties of the ribbon buttons. To learn more about that take a look at the [Common Functionality](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-buttons/overview#Common_Functionality) section of this topic. To learn more about the states of the **RadRibbonGroup** take a look at [this](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-controls/ribbon-group) topic. ## Common Functionality As it was mentioned above all **RadRibbonButtons** derive from the base button controls. Each of them inherits the specifics of the respective button and implements additional functionality. Although they are different controls, there is a common set of properties explained below. * **Text**: A property ot type string that gets or sets the text label that is shown in **Medium** and **Large** button state. * **SmallIcon**: A property of type **IconElement** that gets or sets the icon that is shown in **Medium** and **Small** button state. * **LargeIcon**: A property of type **IconElement** that gets or sets the icon that is shown in **Large** button state. * **Size**: A property of type **ButtonSize** that gets or sets the button initial size. This will be the maximum size of the button as well. * **SplitText**: Enables or disables the text wrapping for the large-sized button. This property is available only for the **RadRibbonSplitButton, RadRibbonDropDownButton, RadRibbonButton**. * **CollapseToSmall**: Specifies when the button will be collapsed to its **Small** state, depending on the state of the **RadRibbonGroup** it belongs to. * **CollapseToMedium**: Specifies when the button will be collapsed to its **Medium** state, depending on the state of the **RadRibbonGroup** to which it belongs. > The **CollapseToSmall** and **CollapseToMedium** properties use the **CollapseThreshold** enumeration. It has the following values: > \***Never**: Indicates that the button will never collapse to **Small**/**Medium** state. This is the default value of the properties. > \***WhenGroupIsMedium**: Indicates that the button will go to the **Small**/**Medium** state when its **RadRibbonGroup** is in **Medium** state. > \***WhenGroupIsSmall**: Indicates that the button will go to the **Small**/**Medium** state when its **RadRibbonGroup** is in **Small** state. * **IsAutoSize**: Specifies whether the button **Icon** will be sized accordingly to the **RibbonView** guidance specification. If set to **False**, the button will display its icons (both Small and Large) in its original size. Otherwise the **SmallIcon** will be displayed with size of 16x16px and the **LargeIcon** will be displayed with size of 32x32px. * **TextRow1**: Gets the text that is shown in **Medium** and **Large** button state. * **TextRow2**: Gets the text that is shown in the **Large** button state. ## Example Here is an example of a **RadRibbonButton** with the following properties set. #### **Example 1: RadRibbonButton Example** ```XAML ``` This button has its initial size set to **Large** and its text label set to **"Admin"**. As the **IsAutoSize** property is set to **True**, the button will change its size depending on the **RadRibbonGroup's** size. The button will also never collapse to its **Medium** size and will collapse to its Small size when the **RadRibbonGroup** collapses to **Medium**. ## See Also * [Ribbon Group](https://www.telerik.com/winui/documentation/controls/radribbonview/ribbon-controls/ribbon-group) * [Resizing](https://www.telerik.com/winui/documentation/controls/radribbonview/features/resizing) * [Ordered Wrap Panel](https://www.telerik.com/winui/documentation/controls/radribbonview/layout-controls/ordered-wrap-panel) * [Collapsible Panel](https://www.telerik.com/winui/documentation/controls/radribbonview/layout-controls/collapsible-panel)