WPF Controls v24.1.3 Maintenance Release

A new WPF Controls maintenance release is now available.

Detailed Update List

Bar Code

• Updated QRCodeSymbology to support Extended Channel Interpretation (ECI), which allows all UTF-8 characters.

Bars

• Added the Ribbon.AreTabsVisible property, which can be set to false to hide ribbon tabs when there is only a single tab in the ribbon. It is recommended to also hide the application button and the tab row toolbar when using this feature.
• Added the Ribbon.GroupLabelMode property, which can be set to Always when a ribbon in Simplified layout mode should display group labels.
• Added the BarComboBox.InlineImageSourcePath property that can bind to an ImageSource-based property on the selected gallery item to render a small image next to the inline text.
• Added the RibbonBackstageViewModel.SelectedItem property to allow the selected tab to be controlled using MVVM.
• Added the RibbonBackstageTabViewModel.VariantSize property to allow variant sizing to be controlled using MVVM.
• Added IsVisible property to appropriate view models to toggle the visibility of the corresponding control.
• Added AllowLabelsOnQuickAccessToolBar property to RibbonViewModel.
• Added the BarMenuItem.CanSelectOnPointerOver property.
• Added the RibbonQuickAccessToolBar.KeyTipTextPrefix property, which can optionally be set when the auto-generated numeric key tip text for QAT items might conflict with ribbon tab key tip text.
• Updated the Layout Modes QuickStart to demonstrate the new Ribbon.AreTabsVisible and GroupLabelMode features.
• Updated ribbon tab appearance when the ribbon is in a minimized state.
• Updated BarComboBox to open the popup when the Alt+Down key is pressed.
• Updated how BarComboBox restores focus when its popup is open and the Esc key is pressed.
• Updated a non-editable BarComboBox to open the popup when the Up or Down arrow keys are pressed.
• Updated a non-editable BarComboBox to support text search.
• Updated an editable BarComboBox that programmatically receives focus to move focus to its embedded TextBox.
• Updated BarComboBoxAutomationPeer to implement IValueProvider.
• Updated BarComboBoxViewModel's calls to SelectItemByValueMatch to support overridden versions.
• Updated RibbonQuickAccessToolBar when in a title bar to better support menu mode focus tracking.
• Updated RibbonBackstage tabs and buttons to support wrapping of long labels.
• Updated RibbonBackstage tabs to support coerced images when the small and/or large image source is undefined.
• Updated BarPopupButtonBase logic for ensuring the popup is at least as wide as the button to work better with menu galleries.
• Updated the BarMenuGallery filter button to show in the UIA peer tree when visible.
• Updated BarMenuGallery in a popup that is opened via key tip to properly commit the initially-selected gallery item on Enter or Space press.
• Updated BarSplitButtonAutomationPeer to return a control type of SplitButton instead of MenuItem.
• Updated the themes to use SystemThemeCatalogRegistrar.
• Updated KeyTipTextGenerator logic for examining labels to better handle other cultures.
• Updated screen tip positioning logic.
• Updated serialization to include support for the Ribbon.AllowLabelsOnQuickAccessToolbar property.
• Updated BarSplitMenuItem to support display of input gesture text.
• Updated how disabled button images render when in a title bar QAT that requires monochrome images.
• Updated how data contexts are cleared for generated controls.
• Fixed an issue where a RibbonGallery popup might not cover the gallery properly on touchscreen PCs.
• Fixed IsInputGestureTextVisible property incorrectly defaulting to false instead of true.
• Fixed RibbonContextualTabItemForegroundHoverBrushKey theme resource being applied to non-contextual tabs instead of contextual tabs. Updated the RibbonContextualTabItemForegroundHoverBrushKey to be the same as RibbonContextualTabItemForegroundNormalBrushKey since modern themes do not change foreground on mouse over.
• Fixed an issue where key tips in a Window with RTL flow direction appeared reversed.
• Fixed an issue where BarSplitMenuItem screen tip placement could be on the wrong side.
• Fixed an issue where switching from Classic layout mode to Simplified layout mode and back might keep some controls hidden.
• Fixed an issue where a BarCheckBox that was overflowed to a menu in simplified layout would not update the IsChecked property when the menu item was invoked.
• Fixed an issue where a BarTextBox that was overflowed to a menu in simplified layout would not update the Text property when the menu item was updated.

Docking

• Added a Bars Integration sample showing how Ribbon and StandaloneToolBar can be used on a main Window without changing the active docking window when there are floating docking windows.
• Added the DockSite.FloatingWindowOwnerMode property that can be set to Always to force floating windows with MDI to always remain on top of the main window.
• Added UIA peers for scroll and overflow buttons within docking window containers.
• Updated the tabbed MDI open documents menu to include DocumentWindow.FileName as a tooltip on menu items.
• Updated how the ToolWindow.ContainerAutoHideSize property is set.
• Updated context menus to support access keys.
• Fixed an issue where an exception could be thrown when drag-docking windows in a certain scenario.

Editors

• Added the AutoCompleteBox.CanAutoSelectFirstItem property that determines if the first suggestion item can be automatically selected in certain scenarios, such as when typing is occurring.

Grids

• Updated TreeListBox to not request bringing a tree node that is stopping editing into view.
• Updated context menus to support access keys.
• Fixed an issue where inserting TreeListBox nodes when filtering was active could lead to the new node displaying in the wrong location.
• Fixed an issue where TreeListView tree lines could scroll horizontally when there were frozen columns.
• Fixed an issue where TreeListBoxItemAdapter.OnDragHover was passed the incorrect target item.

Ribbon

• Updated the Group template to better handle UIA peer updates in .NET 8.

Shell

• Updated RAR files to be treated like files instead of expandable archive folders within a TreeListBox.
• Fixed an issue where Shell context menus could throw an exception in a certain scenario.

SyntaxEditor

• Updated all key processing to consistently handle modifier keys.
• Updated the logic for pasting a full line when there is a selection to match current Visual Studio editor behavior.
• Updated IntelliPrompt completion session logic for canceling the session if the placement bounds are no longer in view.
• Updated data bindings to the SyntaxEditor.Text property to support OneWay mode.
• Updated hit test logic.
• Fixed an issue where the IntelliPrompt completion list might cover the caret when very near the left edge of the screen.

.NET Languages Add-on

• Updated IntelliPrompt tips to include documentation comment remarks sections, if available.
• Updated the Roslyn binary assembly loading logic.
• Updated C# context factory logic related to range operators.

Themes

• Added the WindowChrome.CanMouseActivateOverToolBar property, which can be set to false to prevent the containing Window from being activated on click over any control with the WindowChrome.ElementKind attached property set to ToolBar.
• Improved menu item check border contrast in dark themes.
• Updated style setter bindings on several ItemsControl item containers.
• Updated the ThemeManager attached property for setting the theme on a hierarchy to work when no WPF Application is available.

Shared

• Improved PopupResizeGrip resize logic.
• Improved DynamicImage logic for determining when to update images.
• Fixed an issue with InfoBar throwing an exception during the arrange pass if the available width was too small.
• Fixed an issue UserPromptBuilder not invoking the BeforeShow callback.
• Fixed an issue where ITextLayout may not apply text formats properly in a certain scenario.