Share via


Android でのエントリの入力方式のエディター オプション

この Android プラットフォーム固有の機能は、Entry のソフト キーボードの入力方式エディター (IME) のオプションを設定します。 これには、ソフト キーボードの下隅にあるユーザー アクション ボタンの設定や、Entry との相互作用が含まれます。 Entry.ImeOptions 添付プロパティを列挙型の値 ImeFlags に設定することで、XAML で使用されます。

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

または、Fluent API を使用して C# から使用することもできます。

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

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

Entry.On<Android> メソッドは、このプラットフォーム固有設定が Android 上でのみ実行されるように指定します。 Xamarin.Forms.PlatformConfiguration.AndroidSpecific 名前空間の Entry.SetImeOptions メソッドは、Entry のソフト キーボードの入力方式アクション オプションを設定するために使用され、ImeFlags 列挙型は次の値を指定します。

  • Default: 特定のアクション キーが必要なく、可能な場合は基になるコントロールで独自のアクション キーが生成されることを示します。 値は Next または Done のいずれかになります。
  • None: アクション キーが使用できないことを示します。
  • Go: アクション キーが「移動」操作を実行し、入力したテキストのターゲットへユーザーを誘導することを示します。
  • Search: アクション キーが「検索」操作を実行し、ユーザーが入力したテキストの検索結果を表示することを示します。
  • Send: アクション キーが「送信」操作を実行し、テキストをターゲットに配信することを示します。
  • Next: アクション キーが「次へ」操作を実行し、テキスト入力を受け入れることができるように、次のフィールドにユーザーを誘導することを示します。
  • Done: アクション キーが「完了」操作を実行し、ソフト キーボードを閉じることを示します。
  • Previous: アクション キーが「前へ」操作を実行し、テキスト入力を受け入れることができるように、前のフィールドにユーザーを誘導することを示します。
  • ImeMaskAction: アクションのオプションを選択するマスク。
  • NoPersonalizedLearning: スペル チェック機能がユーザーから学習したり、ユーザーが以前入力した内容に基づいて修正候補を提供したりしないことを示します。
  • NoFullscreen: UI が全画面表示にならないことを示します。
  • NoExtractUi: 抽出されたテキストに対して UI が表示されないことを示します。
  • NoAccessoryAction: カスタム アクションに対して UI が表示されないことを示します。

その結果、指定した ImeFlags 値が Entry のソフト キーボードに適用され、入力方法のエディター オプションが設定されます。

エントリ入力方式エディターのプラットフォーム固有設定