feat: add hidesuggestions property to textbox

[jcsawyer]

What does the pull request do?

Add a ShowSuggestions property to TextInputOptions that when set to false on a text box, the keyboard does not show the autocomplete/word suggestions above the keyboard on Android/iOS.

What is the updated/expected behavior with this PR?

Android/iOS keyboards do not present suggestions when the new ShowSuggestions property is set to false.

Checklist

• Added unit tests (if possible)? (please tell me if there's tests I'm missing here...)
• Added XML documentation to any related classes?
• Consider submitting a PR to https://github.com/AvaloniaUI/avalonia-docs with user documentation

Breaking changes

Fixed issues

Fixes #16579

[avaloniaui-bot]

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

[cla-avalonia]

• All contributors have signed the CLA.

[jcsawyer]

@cla-avalonia agree

[avaloniaui-bot]

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

[avaloniaui-bot]

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

[avaloniaui-bot]

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

[MrJul]

API diff for review:

 namespace Avalonia.Input.TextInput
 {
     public class TextInputOptions
     {
+        public static readonly AttachedProperty<System.Boolean> HideSuggestionsProperty;
+        public System.Boolean HideSuggestions { get { throw null; } set { } } 
+        public static System.Boolean GetHideSuggestions(StyledElement avaloniaObject) { throw null; }
+        public static void SetHideSuggestions(StyledElement avaloniaObject, System.Boolean value) { }
     }
 }

[MrJul]

Notes from the API review meeting:

The default behavior varies by platform: suggestions are enabled by default on mobile and disabled on desktop. This requires a default state, with a nullable boolean, and null being the default value.

Plus, the negative name isn't ideal, so we chose to go with ShowSuggestions instead.

Expected API:

public class TextInputOptions
{
    public static readonly AttachedProperty<bool?> ShowSuggestionsProperty;
    public bool? ShowSuggestions { get; set; } 
    public static bool? GetShowSuggestions(StyledElement);
    public static void SetShowSuggestions(StyledElement, bool?);
}

[avaloniaui-bot]

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

[jcsawyer]

API updated according to specified.

[MrJul]

A few minor points and this is good to go!

[MrJul]

LGTM, thank you!

[avaloniaui-bot]

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