Add ability to cancel focus change

[emmauss]

What does the pull request do?

Adds the following api;

public class FocusChangingEventArgs : RoutedEventArgs
    {
        /// <summary>
        /// Gets or sets the element that focus has moved to.
        /// </summary>
        public IInputElement? NewFocusedElement { get;  }

        /// <summary>
        /// Gets or sets the element that previously had focus.
        /// </summary>
        public IInputElement? OldFocusedElement { get; }

        /// <summary>
        /// Gets or sets a value indicating how the change in focus occurred.
        /// </summary>
        public NavigationMethod NavigationMethod { get; }

        /// <summary>
        /// Gets or sets any key modifiers active at the time of focus.
        /// </summary>
        public KeyModifiers KeyModifiers { get; }

        /// <summary>
        /// Gets whether focus change is canceled.
        /// </summary>
        public bool Cancelled { get; }

        /// <summary>
        /// Attempts to cancel the current focus change
        /// </summary>
        /// <returns>true if focus change was cancelled; otherwise, false</returns>
        public bool TryCancel();

        /// <summary>
        /// Attempts to redirect focus from the targeted element to the specified element.
        /// </summary>
        public bool TrySetNewFocusedElement(IInputElement? inputElement);
    }

Adds the following events and callbacks to InputElement

public static readonly RoutedEvent<FocusChangingEventArgs> GettingFocusEvent;
public static readonly RoutedEvent<FocusChangingEventArgs> LosingFocusEvent;
protected virtual void OnGettingFocus(FocusChangingEventArgs e);
protected virtual void OnLosingFocus(FocusChangingEventArgs e);

These api allow controls to cancel any focus change that affects them, as long as the toplevel allows. There are situations where cancelling is not allowed, like when the toplevel loses focus.

What is the current behavior?

Focus change can't be cancelled currently. There's no api to lock focus on a control. There are cases where you want to keep keyboard focus on a control while still being able to interact with other controls, like the case of a textbox in a chat app.

What is the updated/expected behavior with this PR?

How was the solution implemented (if it's not obvious)?

Checklist

• Added unit tests (if possible)?
• Added XML documentation to any related classes?
• Consider submitting a PR to https://github.com/AvaloniaUI/avalonia-docs with user documentation

Breaking changes

Obsoletions / Deprecations

Fixed issues

[maxkatz6]

Can you add a unit test with focus redirection?
Is it possible by a direct focus in this PR? Or do we need something like this https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.input.gettingfocuseventargs.trysetnewfocusedelement?view=windows-app-sdk-1.6 ?

[emmauss]

Added.

wait for api review

[avaloniaui-bot]

You can test this PR using the following package version. 11.3.999-cibuild0055695-alpha. (feed url: https://nuget-feed-all.avaloniaui.net/v3/index.json) [PRBUILDID]