Converting to v26.1

Avalonia v12.0.0 Updates

The following breaking changes were necessary to support and/or align with changes in Avalonia v12.0.0:

• Renamed ThemeResourceKind.EditWatermarkOpacity to EditPlaceholderOpacity.
• Renamed ThemeResourceKind.EditWatermarkOpacityFocused to EditPlaceholderOpacityFocused.
• Removed ControlThemeKind.CaptionButtons and corresponding ControlTheme since the native CaptionButtons control was removed.
• Removed ControlThemeKind.TitleBar and corresponding ControlTheme since the native TitleBar control was removed.
• Any overrides for OnGotFocus changed event arguments from GotFocusEventArgs to FocusChangedEventArgs.
• Any overrides for OnLostFocus changed event arguments from RoutedEventArgs to FocusChangedEventArgs.

Menu Factory Updates

Several minor updates were made to Menu Factory concepts in order to align functionality and capabilities with other Actipro platforms. Most of these changes only affect those who have implemented their own IMenuFactory implementations, but the default MenuItem.Name of some menu items have also changed. If any default menus are being customized and the MenuItem.Name was used to find existing menu items without using one of the available constants, verify that the correct menu name is still in use.

The following potentially breaking changes were made:

Shared Library

• The IMenuFactory.CreateMenuFlyout method has been renamed as CreateMenu.
• The MenuFactoryCreateMenuFlyoutOptions class has been renamed to MenuFactoryMenuOptions.
• The MenuFactoryCreateMenuItemOptions class has been renamed to MenuFactoryMenuItemOptions.
  • The Name property on this class has been renamed to Key.
• The MenuFactory class has been split into two classes:
  • A static MenuFactory class that stores a reference to the Current and Default factory instances.
  • A generic MenuFactory<T,U,V> class where generic arguments are used to define the type of menu, menu item, and menu separator created by the factory.
  • The old MenuFactory.CreateMenuFlyout virtual method has been replaced by CreateMenu that is no longer virtual. Override CreateMenuCore to customize the menu.
  • The old MenuFactory.CreateMenuFlyoutCore virtual method has been replaced by CreateMenuItemCore.
  • The old MenuFactory.CreateMenuSeparator virtual method has been replaced by CreateMenuSeparator that is no longer virtual. Override CreateMenuSeparatorCore to customize the menu separator.
• The MenuFactory.CreateMenuFlyout method has been renamed as MenuFactory<T,U,V>

Bars

• The Bars IMenuFactory implementation BarsMenuFactory has been moved from the ActiproSoftware.UI.Avalonia.Controls namespace to the ActiproSoftware.UI.Avalonia.Controls.Bars namespace.
• The base class for BarsMenuFactory has been changed to the new MenuFactory<T,U,V> class along with the necessary conversions required by the class.
• A ScreenTip is closed when a key is pressed. Previously, the ScreenTipService.CurrentScreenTip property would remain assigned until all key-related events had completed processing. Due to backend changes in Avalonia v12, the ScreenTipService.CurrentScreenTip property will only be populated in KeyDown events. Any logic reliant on CurrentScreenTip that currently resides in a KeyUp event will need to be migrated to a KeyDown event. This, for example, might impact any logic that might have been used to show contextual help for a ScreenTip when the F1 key was pressed.

Docking

The Docking MenuItemNames class has been renamed to CommandKeys and moved to the ActiproSoftware.Properties.Docking namespace. Additionally, some constants were renamed as follows:

• CloseAllInContainer renamed to CloseAll.
• CloseWindow renamed to Close.
• FloatAllInContainer renamed to FloatAll.
• MakeDockedWindow renamed to Dock.
• MakeDocumentWindow renamed to MoveToMdi.
• MakeFloatingWindow renamed to Float.
• MoveToPrimaryMdiHost renamed to MoveToPrimaryMdi.
• ToggleWindowAutoHideState renamed to AutoHide.

The value of each constant was updated to match new naming conventions as follows: