Teilen über


Eingabemethoden-Editoroptionen für Eingabemethoden unter Android

Diese plattformspezifische Android-Plattform legt die Optionen des Eingabemethoden-Editors (IME) für die Softtastatur für eine Entry. Dazu gehören die Einstellung der Benutzeraktionstaste in der unteren Ecke der Bildschirmtastatur und die Interaktionen mit dem Entry. Sie wird in XAML verwendet, indem sie die angefügte Eigenschaft Entry.ImeOptions auf einen Wert der ImeFlags Aufzählung festlegt:

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

Alternativ kann sie mit der Fluent-API von C# genutzt werden:

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

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

Die Entry.On<Android> Methode gibt an, dass diese plattformspezifische Eigenschaft nur unter Android ausgeführt wird. Die Entry.SetImeOptions Methode wird im Xamarin.Forms.PlatformConfiguration.AndroidSpecific Namespace verwendet, um die Eingabemethoden-Aktionsoption für die Softtastatur für Entry festzulegen, wobei die ImeFlags Aufzählung die folgenden Werte bereitstellt:

  • Default - zeigt an, dass keine spezifische Aktionstaste erforderlich ist und dass das zugrunde liegende Steuerelement nach Möglichkeit seine eigene erzeugt. Dies ist entweder Next oder Done.
  • None - gibt an, dass kein Aktionsschlüssel verfügbar gemacht wird.
  • Go – gibt an, dass der Aktionsschlüssel einen Go-Vorgang ausführt und den Benutzer zum Ziel des eingegebenen Texts führt.
  • Search – gibt an, dass der Aktionsschlüssel einen Suchvorgang ausführt und den Benutzer zu den Ergebnissen der Suche nach dem eingegebenen Text führt.
  • Send – gibt an, dass der Aktionsschlüssel einen "Send"-Vorgang ausführt und den Text an das Ziel übermittelt.
  • Next - zeigt an, dass die Aktionstaste eine "Weiter"-Operation ausführt, die den Benutzer zum nächsten Feld führt, welches Text akzeptiert.
  • Done – gibt an, dass die Aktionstaste einen "Done"-Vorgang ausführt und die Bildschirmtastatur schließt.
  • Previous – gibt an, dass der Aktionsschlüssel einen "Previous"-Vorgang ausführt, der den Benutzer zum vorherigen Feld führt, welches Text akzeptiert.
  • ImeMaskAction - die Maske zum Auswählen von Aktionsoptionen.
  • NoPersonalizedLearning - gibt an, dass die Rechtschreibprüfung weder vom Benutzer lernt, noch Korrekturen vorschlägt, die auf vorherigen Eingaben des Benutzers basieren.
  • NoFullscreen - gibt an, dass die Editor-Benutzeroberfläche nicht im Vollbildmodus angezeigt werden soll.
  • NoExtractUi - gibt an, dass keine Benutzeroberfläche für extrahierten Text angezeigt wird.
  • NoAccessoryAction - gibt an, dass keine Benutzeroberfläche für benutzerdefinierte Aktionen angezeigt wird.

Das Ergebnis ist, dass ein angegebener ImeFlags Wert auf die Bildschirmtastatur für Entry angewendet wird, welche die Eingabemethoden-Editor-Optionen festlegt:

Plattformspezifische Eingabemethoden-Editor für Eingabemethoden