HamburgerMenu and Item selection/hover brush improvements

[punker76]

What changed?

HamburgerMenu

• Renaming:
  • HamburgerListBoxItemStyle -> HamburgerMenuItemStyle
  • HamburgerListBoxStyle -> HamburgerMenuListStyle
• Revert back to UWPCommunityToolkit style (update template to keep options visible)
  • Move template to HamburgerMenuTemplate resource dictionary
  • Add margins
  • Vertically stretch the menu items of the hamburger menu
• Change inner ListBox scrolling (CanContentScroll)
• Add ItemContainerStyle and OptionsItemContainerStyle properties. This makes it easier to change the inner styles for the items (and option items)^
• MinHeight of the menu items should be 0
• HamburgerMenuImageItem: Downgrade thumbnail property from BitmapImage to subclass ImageSource
• Introduce ItemInvoked event (as an alternative to ItemClick and OptionsItemClick)
• SelectionIndicator which can be enabled with the new ShowSelectionIndicator dependency property
• Improved item FocusVisualStyle
  • Add new (readonly) ItemFocusVisualStyle dependency property which will be re-created if one of these properties are changed: OpenPaneLength, CompactPaneLength and IsPaneOpen.
  • Default template is HamburgerMenuItemFocusVisualTemplate.
  • This FocusVisualStyle can be override at the HamburgerMenuItem style by setting the FocusVisualStyle property.
• Reorganize Hamburger sample: shows now Default style, Creators Update style and a sample with the MaterialDesignInXaml Ripple control

ToggleSwitch

• New ContentPadding dependency property. Add this new property to change the padding of the inner content in an easy way.

ItemHelper

• New helper class with Brush attached properties for mouse interaction. These properties can be used with HamburgerMenuItem, ListBoxItem, ListViewItem, TreeViewItem and ComboBoxItem.
  • ActiveSelectionBackgroundBrush default AccentColorBrush
  • ActiveSelectionForegroundBrush default AccentSelectedColorBrush
  • DisabledBackgroundBrush default x:Null
  • DisabledForegroundBrush default GrayNormalBrush
  • DisabledSelectedBackgroundBrush default GrayBrush7
  • DisabledSelectedForegroundBrush default AccentSelectedColorBrush
  • HoverBackgroundBrush default AccentColorBrush3
  • HoverSelectedBackgroundBrush default AccentColorBrush
  • SelectedBackgroundBrush default AccentColorBrush2
  • SelectedForegroundBrush default AccentSelectedColorBrush

Closes #2931
Closes #2975
Closes #2979

[amkuchta]

[amkuchta]

@punker76 how do I expose HamburgerMenuItemStyle so that I can create my own HamburgerMenuCreatorsItemStyle as you have done in HamburgerMenuCreatorsUpdate.xaml? Should we consider making both HamburgerMenuCreatorsItemStyle and HamburgerMenuCreatorsStyle out-of-the-box styles for ease of use?