v11.0.0

11.0.0

Breaking changes

• Dropped support for .NET 5.0 and .NET 3.1. Added .NET 6.0 and .NET 8.0 instead
• Aligned theming with current office versions
• Backstage
  • Removed default MinWidth on the button responsible for opening
  • Saving and restoring window sizes were removed
• BackstageTabControl
  • IsWindowSteeringHelperEnabled and SelectedContentMargin were removed
• BackstageTabItem
  • Selection now happens on left mouse button down instead of up
  • Selection now happens on focus retrieval instead of Space or Enter key press
• RibbonContextualTabGroup
  • Width is now always the width of it's containing tabs
• RibbonGroupBox
  • Changed default Padding from 0 to 0 4 0 0
  • Removed method ClearCache
• RibbonTabItem
  • Changed default HeaderPadding from 8 5 8 5 to 9 7 9 7.
    
    Padding is gradually increased/decreased when the available space changes.
    
    Down to a minimum of 5 for left/right.
  • Replaced IsSeparatorVisible by SeparatorOpacity
  • Changed default Padding from 0 to 4 0 4 0
  • Padding is now forwarded to the Margin of the content
  • Active border thickness (underline) can be changed by overwriting Fluent.Ribbon.Values.RibbonTabItem.Active.BorderThickness
  • Default HeaderTemplate now contains two TextBlock
• RibbonTabControl
  • PART_SelectedContentPresenter was renamed to PART_SelectedContent and can be of type FrameworkElement.
    
    The default template uses the new TransitioningControl.
    
    The used transition can be changed by overwriting the resource Fluent.Ribbon.Values.RibbonTabControl.Content.Transition.
  • DefaultContentGapHeight changed from 1 to 3
  • DefaultContentHeight changed from 94 to 100
  • Corner radius for item display can be changed by Fluent.Ribbon.Values.RibbonTabControl.Content.CornerRadius
  • Drop shadow can be changed by overwriting Fluent.Ribbon.Values.RibbonTabControl.Content.DropShadowEffect
  • Content margin can be changed by overwriting Fluent.Ribbon.Values.RibbonTabControl.Content.Margin
• RibbonTitleBar
  • Changed default HideContextTabs from false to true
• RibbonWindow
  • Default Background is now Fluent.Ribbon.Brushes.RibbonWindow.Background
• ScreenTip
  • Type for Image was changed from ImageSource to object to allow any image content
  • Type for Text was changed from string to object to allow rich content (see #716)
• DropDownButton, SplitButton and ApplicationMenu don't generate MenuItem but ContentPresenter as containers.
  
  This provides more flexibility and also fixes the nested MenuItem issues.
• Removed default style assignment for ScrollBar
• Themes
  • All
    • Quite a few colors/brushes changed
  • Dark
    • Fluent.Ribbon.Colors.White changed from #FF252525 to #FF000000

Enhancements/Features

• Added TabItemForeground to RibbonContextualTabGroup
• Added resource Fluent.Ribbon.Brushes.RibbonWindow.Background
• Added TransitioningControl to animate content changes
• Added IsBackstageOrStartScreenOpen on Ribbon
• #716 - Unable to use rich content for ScreenTip
  • Changed text from string to object and added TextTemplate to ScreenTip to support this
• #719 - Make StatusBarItems always visible
  • Added IsCheckable to StatusBarItem which defaults to true
• RibbonProperties
  • Added PressedBackground (used in Fluent.Ribbon.Styles.WindowCommands.CaptionButton etc.)
  • Added CornerRadius (used for RibbonTabControl, Fluent.Ribbon.Templates.ScrollButton etc.)
• Selecting an RibbonTabItem brings it into view now
• Improved keyboard navigation inside BackstageTabControl
• Improved mouse wheel selection on RibbonTabControl
• DropDownButton
  • Added support for UsesItemContainerTemplate and ItemContainerTemplateSelector
• MenuItem
  • Added support for UsesItemContainerTemplate and ItemContainerTemplateSelector
  • IsSplit is now automatically set by a style trigger. If Command is not null and HasItems is true.
• RibbonMenu
  • Added support for UsesItemContainerTemplate and ItemContainerTemplateSelector
• Added ExpandButtonContent and ExpandButtonContentTemplate to InRibbonGallery

Bug fixes

• #1162 - Maximum dropdown height is not screen aware
• #1196 - GroupName causes the selected ToggleButton to no longer trigger the click event
• #1218 - Selected tab is lost on screen changes (thanks @cbra-caa)
• #1222 - Icon property values of controls are translated by the translation tools like catalyst (thanks @avikramaditya)
• #1227 - Button events inside split button do not fire when ClosePopupOnMouseDownDelay = 0
• #1228 - ComboBox dropdown is empty when expanding for the first time when specifying ItemsPanelTemplate in order to add Grouping
• Value of HideContextTabs are now properly restored when Backstage is closed
• RibbonTitleBar
  • Fixed rendering when HideContextTabs is true
  • Rendering now updates when QAT is shown/hidden
• Opening Backstage/StartScreen now properly sets the focus to it's content (BackstageTabControl, StartScreenTabControl etc.)
• Fixed mouse over for Fluent.Ribbon.Templates.WindowCommands.CaptionButton
• Fixed selection events for BackstageTabControl, BackstageTabItem, GalleryItem, InRibbonGallery, RibbonTabControl and RibbonTabItem

v10.1.0

• Bug fixes

  • Simplified state was not updated when items changed
  • #1165 - ScreenTip is not DPI aware
  • #1183 - MenuItems, having a submenu, do not stay highlighted when MenuItem from the submenu is highlighted
  • #1185 - LauncherIcon not rendered correctly and items in QAT can be removed from QAT in it's popup
  • #1191 - Popup of DropDownButton/SplitButton has unwanted MinHeight

• Enhancements/Features

  • Performance of measuring (and thus rendering) of RibbonTabItem (and it's contents) was improved by reducing the amount of measures required.
    Most of the time there should only be one or two measure calls when switching tabs, compared to six or eight in case of the showcase application.
    This is mostly achieved by getting rid of internal caching. The caching turned out to be more expensive than not caching at all.
  • Added RibbonProperties.CustomIconSize as an attached property. This is used inside control templates to set CustomSize of IconPresenter.
  • Default value of IsHitTestVisible is now false on IconPresenter.
  • #1177 - RibbonComboBox cannot be customized based on the original RibbonComboBox style (thanks @nishy2000)
  • #1180 - Padding and BorderBrush of the gallery control do not work (thanks @nishy2000)

v10.0.4

• Bug fixes

  • #1165 - ScreenTip is not DPI aware

v10.0.3

• Bug fixes

  • #1155 - Update Russian translation
  • #1161 - RibbonBackButton - Localization Mix

v10.0.2

• Bug fixes

  • #1125 - BackStage Back Button doesn't have an accessibility text.

v10.0.1

• Bug fixes

  • #1133 - Fixing binding path to attached property for simplified ControlTemplates (thanks @dcm99)
  • #1134 - Selected Tab on first render has a black border
  • #1135 - Black line between Ribbon and Window (when using a colorful theme)
  • #1125 - BackStage Back Button doesn't have an accessibility text.
  • #1151 - ComboBox Popup MinWidth too large
  • #1152 - Using ObjectToImageConverter via StaticResource raises an exception (thanks @nishy2000)

v10.0.0

• Breaking changes

  • Dropped support for .NET 4.5.2. The lowest support .NET version is now 4.6.2.
  • Dropped support for .NET 5.0 and add .NET 6.0 instead.
  • Resizing popups should now work properly where supported (ComboBox, DropDownButton, InRibbonGallery, MenuItem, SplitButton).
    Templates now use the new specialized ResizeableContentControl to enable this.
    Resize code was moved from single controls to the new control.
  • Updated ControlzEx to version 6.
    • RibbonWindow now inherits from WindowChromeWindow
    • GlowBrush and NonActiveGlowBrush are now named GlowColor and NonActiveGlowColor and are both of type Color instead of Brush
    • Default value for BorderThickness changed from 1 to 0
  • PDBs are now embedded
  • Removed IsMinimized and IsOpen from RibbonTabItem
  • HeaderTemplate and HeaderTemplateSelector were added to IHeaderedControl
  • Various controls (Button, ComboBox etc.) now use HeaderTemplate to format their header instead of using TwoLineLabel directly
  • #948 - Minimize button misplaced
    Minimize button was moved to the right hand side of the toolbar in the tab item row
  • All resources now have the prefix Fluent.Ribbon..
    This means that nearly all resources got renamed.

• Bug fixes

  • #1035 - Binding failures from within RibbonTabItem on IsMinimized & IsOpen
  • #1041 - MenuItem CreateQuickAccessItem should create ToggleButton (thanks @andersforsgren)
  • #1070 - Separators no longer shown in Backstage (related to #936)
  • #1081 - Fix InvalidOperationException thrown when switching focus from editable ComboBox to Hyperlink (thanks @orrindeng)
  • #1087 - Multiple levels of menu items of DropDownButton behaves not well (thanks @orrindeng)
  • #1092 - Fix on some computers, the gallery layout is not good (thanks @orrindeng)
  • #1095 - Add missing localizations for the danish language (thanks @cbra-caa)
  • #1096 - BackstageTabItem tooltip shows on content hover (thanks @cbra-caa)
  • #1098 - Collapsed groupboxes are not keyboard accessible (thanks @cbra-caa)
  • #1101 - Backstage button tooltip shows on active backstage (thanks @cbra-caa)
  • #1103 - Backstage.IsOpen is not bindable (thanks @cbra-caa)
  • #1107 - Child sizes are not updated when user switches between Classic/Simplified Ribbon while Ribbon is minimized
  • #1114 - Fix combobox can't open dropdown when the editable textbox of it has the focus (thanks @orrindeng)
  • #1115 - Update Russian translation (thanks @Blueberryy)
  • #1116 - Accessibility: Ribbon Display Options are read as "DropDown Button"
  • #1117 - Accessibility: BackButton has low contrast
  • #1125 - BackStage Back Button doesn't have an accessibility text.
  • #1129 - Popup has been detached by the parent control

• Enhancements/Features

  • #1026 - Translate some Chinese cases (thanks @leixao)
  • #1034 - Enable TextTrimming in Button Header
    To enable this HeaderTemplate and HeaderTemplateSelector were added to IHeaderedControl.
  • #1048 - DismissOnClickOutside property added to DropDownButton (thanks @MuhammadSulaiman001)
  • #1049 - IsDisplayOptionsButtonVisible property is added to RibbonTabControl (thanks @zui-jiu-zhou)
  • #1058 - Add option to use legacy/office-style mouse wheel tab shifting (thanks @andersforsgren)
  • #1091 - Image Resource Viewer (thanks @avalanchus)
  • #1112 - Enhanced FocusVisual for various controls (thanks @cbra-caa)

v9.0.4

• Bug fixes

  • #1014 - Ribbon menu not fully displayed after minimized
  • IconPresenter must not be focusable
  • Fixed mouse over and keyboard focus colors of ComboBox

v9.0.3

• Bug fixes

  • #1004 - Detach from KeyDown event to match code in Show()

v9.0.2

• Bug fixes

  • #999 - Window object not being recycled after ribbon window is closed