Edit this page

Minimization

RadRibbonView supports minimization, which means that the ribbon may be hidden so that only its tab headers remain visible. In this state, more screen real estate is available to the client area of the window.

By clicking a tab header, the ribbon appears in a popup over the window client area and all of its controls are accessible.

There are a few ways for the end user to toggle the minimization state of the RadRibbonView:

  • Double click on any of the tab headers.

  • Choose 'Minimize the Ribbon' under the Quick Access Tool bar menu.

  • Display the MinimizeButton by setting the RibbonView.MinimizeButtonVisibility to Visible and toggling the button state

Properties

The following properties are related to the minimize feature:

  • IsMinimizable - use this property to enable/disable the minimization functionality of the RibbonView. The default value is True.

  • IsMinimized - use this property to set or get the current minimize state of the RibbonView.

  • IsMinimizedPopupOpen - use this property to get whether the minimized popup menu of the RibbonView is opened or not.

Disable the Minimization Functionality

To disable the minimization functionality of the RadRibbonView just set the IsMinimizable property to False. This feature is enabled by default.

XAML

<telerik:RadRibbonView x:Name="radRibbonView" IsMinimizable="False" />

C#

radRibbonView.IsMinimizable = false;

VB.NET

radRibbonView.IsMinimizable = False

Events

  • The MinimizedChanged event is raised when the the ribbon is changing its minimized state. The MinimizedChanged event handler receives two arguments:

    • The sender argument contains the RadRibbonView. This argument is of type object, but can be cast to the RadRibbonView type.
    • A Telerik.Windows.RadRoutedEventArgs object containing all the additional information about the event.
  • The MinimizedPopupOpenStateChanged event is raised when the minimized popup changes its open state. The MinimizedPopupOpenStateChanged event handler receives two arguments:

    • The sender argument contains the RadRibbonView. This argument is of type object, but can be cast to the RadRibbonView type.
    • A Telerik.Windows.RadRoutedEventArgs object containing all the additional information about the event.
  • The PreviewPopupOpened event is raised when the minimized popup is about to be opened. The PreviewPopupOpened event handler receives two arguments:

    • The sender argument contains the RadRibbonView. This argument is of type object, but can be cast to the RadRibbonView type.
    • A Telerik.Windows.RadRoutedEventArgs object containing all the additional information about the event.

    You can cancel the opening of the minimized popup by setting the RadRoutedEventArgs's Handled property to True.

  • The PopupOpened event is raised when the minimized popup changes its open state. The PopupOpened event handler receives two arguments:

    • The sender argument contains the RadRibbonView. This argument is of type object, but can be cast to the RadRibbonView type.
    • A Telerik.Windows.RadRoutedEventArgs object containing all the additional information about the event.