Features / Changes / Fixes

• If a dialog is shown in a window other than the MainWindow, OwningWindow will be used if available to detect the theme. #2840
• Fixed an issue for DateTimePicker when the time is cleared if a date is selected. #2837
• HamburgerMenu changes and improvements
  • New HamburgerMenuIconItem helper class which can be used to put any object icon to the menu item.
  • Fixed tab order and keyboard selection.
  • ItemCommand and OptionsItemCommand
  • Command for HamburgerMenuItem
  • New property PaneForeground for HamburgerMenu and Splitview and new Foreground/Background brushes MahApps.Metro.HamburgerMenu.PaneBackgroundBrush, MahApps.Metro.HamburgerMenu.PaneForegroundBrush
  • Update scroll behavior to match with the UWPCommunityToolkit (see UWP Toolkit Issue #954).
    • Add a new dependency property VerticalScrollBarOnLeftSide to show the vertical scrollbar on the left side
    • Use a disappearing ScrollViewer
  • Add HamburgerVisibility property UWPCommunityToolkit #1020
  • Set Content for HamburgerMenu only if one of the inner ListBox controls has a selected item.
  • New HamburgerMenuHeaderTemplate property to set a header right of the HamburgerMenu button. @SilverDragon135 #2917
  • Implement the interface ICommandSource and handle Command binding change to hook or unhook command executable.
    
  • Add MahApps.Metro.Styles.HamburgerMenu style key to the HamburgerMenu.
• If ShowInTaskbar = false, when double click on the title bar of a minimized window, the window will be restored instead of maximized. #2854 @hausenism
• Fix WindowCommands tab stop bug #2858 @neilt6
• Don't overwrite cancellation for window close event #2868 @batzen
• Expose close button margin for MetroTabItem #2803
• New Badged control. Thx to @ButchersBoy
  
• The ControlsHelper.CornerRadius can now used for SplitButton and DropDownButton.
• New underline types for TabControl and MetroTabControl #2902
  • Adds a new Underlined attached property to TabControlHelper which controls the type of the underline type. The old IsUnderlined property is now obsolete.

  /// <summary>
  /// Specifies the underline position of a TabControl.
  /// </summary>
  public enum UnderlinedType
  {
      None, // nothing
      TabItems, // the old behavior with `IsUnderlined="True"`
      SelectedTabItem, // selected TabItem underlined + underline hover effect for unselected items
      TabPanel // underlined TabPanel and selected/hovered TabItem
  }
  

  • Add also new Brush attached properties to enable easy changing the underline brushes.

  TabControlHelper.UnderlineBrush
  TabControlHelper.UnderlineSelectedBrush
  TabControlHelper.UnderlineMouseOverBrush
  TabControlHelper.UnderlineMouseOverSelectedBrush
  

  
• New underline types also for AnimatedTabControl and AnimatedSingleRowTabControl styles and for MetroAnimatedTabControl and MetroAnimatedSingleRowTabControl #2905
• Fix / improve AnimatedSingleRowTabControl styles
  • Fix template changing (doesn't works if TabStripPlacement was changed)
  • Disappear arrow repeat buttons
  • Use brush, hover and pressed brush like normal ScrollViewer
• Fixed ClearTypeHint and wrong Margin for ComboBox and ComboBoxItem #2903
• Fix ListView style issues
  • Use accent brush for highlighted border
  • Fix SnapsToDevicePixels usage
  • Fix disabled foreground brush
• Fix SnapsToDevicePixels usage for CheckBox
• Flyout changes and improvements
  • Fix Flyout modal usage. All title bar commands are now hidden if a Flyout is modal.
  • Fix background and foreground usage of controls in a Flyout if user changes theme on the fly. #2337 The Flyout has a different background, so we should override some background and foreground brushes and colors.
  • Change Flyout from ContentControl to HeaderedContentControl which has the correct properties for headers.
  • Enable Border for Flyout
• Use GrayBrush7 and WhiteBrush for menu Separator instead fixed colors.
• Fix BindingExpression at DropDownButton. Don't set ItemTemplateto ContentTemplate, ItemTemplateSelector to ContentTemplateSelector and ItemStringFormat to ContentStringFormat. This breaks the whole usage of the content stuff and shows a BindingExpression path error. #2883
• New UsernameCharacterCasing property for LoginDialogSettings #2683
• Fix SelectionChanged event of SplitButton which fires now only once.
• Add TransitionCompleted event to MetroContentControl and WindowTransitionCompleted event to MetroWindow which will be fired after the loaded Storyboard is completed.
• Add new WatermarkAlignment attached property to TextBoxHelper which indicates the horizontal alignment of the watermark (incl. floating watermark).
  
• Add new DataGridHelper with EnableCellEditAssist attached property which enabled direct editing for CheckBox and ComboBox cells. (default to false) Thx to @ButchersBoy (taken from MaterialDesignInXamlToolkit)

Closed Issues

• #2835 ShowMessageAnsync() causes exception
• #2848 HamburgerMenu Command MVVM
• #2866 Validation-Popup won't be opened after closing by mouse left button down
• #2870 MahApps Not Thread Safe But Should Be [Test Case]
• #2877 Can't bind to ShowTitleBar
• #2871 SplitButton CornerRadius
• #2862 Flyout close button icon is incorrect when setting flow direction right to left
• #1938 Problem with window size
• #2066 On Windows 8 a window with height 23px resizes to 39px after dragging
• #2792 Win32Exception on closing window
• #2886 NumericUpDown: HasDecimals=False & using a bound StringFormat allows to enter a decimal point @davericardo
• #2885 [Bug] Badged Control Causes Window Loading to Hang
• #2895 [RFC] [Enhancement] Proposed TabControlHelper.IsUnderlined Change
• #2903 1 pixel space between ComboBoxItems closes ComboBox
• #2841 Modal flyout issue
• #2337 Flyout style from Accent to Light is not working
• #2883 Can Reproduce BindingExpression path error: ... property not found ... On DropDownButton
• #2683 [Question] Force TextBox uppercase in ShowLoginAsync
• #2857 HamburgerMenuItem Scrolling
• #1835 Window animation interferes with WindowsFormsHost positioning
• #2917 Hamburger Header Templating
• #2332 Calendar ignores IsTodayHighlighted property
• #2434 DataGridNumericUpDownColumn foreground color
• #2627 Inconsistent FloatingWatermark Alignment
• #2865 [Feature request]Enable/Disable of Hamburger Menu Item
• #2880 RangeSlider: Inadequate snapping to ticks
• #2812 Font family in Flyout.xaml and MetroNavigationWindow.xaml
• #2764 Flyout - Border not shown
• #2515 NumericUpDown Value not displayed
• #1929 MetroDataGridCheckBox style prevents the CellEditEnding

Don't focus flyout on close #2671 (@ButchersBoy) This hack was introduced with #1805 which was noticed by manual testing.