Partager via

Options de l’éditeur de méthode d’entrée d’entrée sur Android

  • Article

Cette plateforme Android définit les options de l’éditeur de méthode d’entrée (IME) pour le clavier logiciel d’un Entry. Cela inclut la définition du bouton d’action de l’utilisateur dans le coin inférieur du clavier doux et les interactions avec le Entry. Elle est consommée en XAML en définissant la Entry.ImeOptions propriété jointe sur une valeur de l’énumération ImeFlags :

<ContentPage ...
             xmlns:android="clr-namespace:Xamarin.Forms.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.Forms.Core">
    <StackLayout ...>
        <Entry ... android:Entry.ImeOptions="Send" />
        ...
    </StackLayout>
</ContentPage>

Elle peut également être consommée à partir de C# à l’aide de l’API Fluent :

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.AndroidSpecific;
...

entry.On<Android>().SetImeOptions(ImeFlags.Send);

La Entry.On<Android> méthode spécifie que cette plateforme spécifique ne s’exécutera que sur Android. La Entry.SetImeOptions méthode, dans l’espace Xamarin.Forms.PlatformConfiguration.AndroidSpecific de noms, est utilisée pour définir l’option d’action de méthode d’entrée pour le clavier logiciel pour le Entry, avec l’énumération ImeFlags fournissant les valeurs suivantes :

  • Default : indique qu’aucune clé d’action spécifique n’est requise et que le contrôle sous-jacent produit sa propre clé si elle le peut. Cela sera Next soit ou Done.
  • None : indique qu’aucune clé d’action n’est mise à disposition.
  • Go : indique que la clé d’action effectue une opération « go », en prenant l’utilisateur à la cible du texte qu’il a tapé.
  • Search : indique que la clé d’action effectue une opération de « recherche », en prenant l’utilisateur aux résultats de la recherche du texte qu’il a tapé.
  • Send : indique que la clé d’action effectue une opération « envoyer », en fournissant le texte à sa cible.
  • Next : indique que la clé d’action effectue une opération « suivante », en faisant passer l’utilisateur au champ suivant qui accepte le texte.
  • Done : indique que la touche d’action effectue une opération « terminée », fermant le clavier doux.
  • Previous : indique que la clé d’action effectue une opération « précédente », en utilisant l’utilisateur dans le champ précédent qui accepte le texte.
  • ImeMaskAction : masque pour sélectionner les options d’action.
  • NoPersonalizedLearning : indique que le vérificateur d’orthographe n’apprendra pas de l’utilisateur, ni suggère des corrections en fonction de ce que l’utilisateur a précédemment tapé.
  • NoFullscreen : indique que l’interface utilisateur ne doit pas être en mode plein écran.
  • NoExtractUi : indique qu’aucune interface utilisateur n’est affichée pour le texte extrait.
  • NoAccessoryAction : indique qu’aucune interface utilisateur n’est affichée pour les actions personnalisées.

Le résultat est qu’une valeur spécifiée ImeFlags est appliquée au clavier logiciel pour le Entry, qui définit les options de l’éditeur de méthode d’entrée :

Entrée, éditeur de méthode d’entrée spécifique à la plateforme