このページは Cloud Translation API によって翻訳されました。

入力方法のタイプを指定する

テキストフィールドはすべて、メールアドレス、電話番号、または単なるテキストなど、特定の種類のテキスト入力を想定しています。システムが適切なソフト入力方法（画面キーボードなど）を表示するように、アプリの各テキストフィールドに入力タイプを指定する必要があります。

入力方法で使用できるボタンのタイプ以外にも、入力方法でスペルの候補を提供するかどうか、新しい文を大文字にするかどうか、改行ボタンを Done または Next などのアクションボタンに置き換えるかどうかなどの動作を指定できます。このページでは、これらの特性を指定する方法について説明します。

キーボードタイプの指定

<EditText> 要素に android:inputType 属性を追加して、常にテキストフィールドの入力方法を宣言する必要があります。

たとえば、電話番号の入力方法を指定する場合は、"phone" 値を使用します。

<EditText
    android:id="@+id/phone"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:hint="@string/phone_hint"
    android:inputType="phone" />

textPassword 入力タイプ — **図 2.** `textPassword` 入力タイプ。

テキストフィールドがパスワード用の場合は、"textPassword" 値を使用して、テキストフィールドでユーザーの入力が隠されるようにします。

<EditText
    android:id="@+id/password"
    android:hint="@string/password_hint"
    android:inputType="textPassword"
    ... />

android:inputType 属性の有効な値はドキュメントに記載されており、一部の値を組み合わせて入力メソッドの外観と追加の動作を指定できます。

スペルの候補と他の動作の有効化

android:inputType 属性を使用すると、入力メソッドのさまざまな動作を指定できます。最も重要なことは、テキストフィールドが基本的なテキスト入力（テキストメッセージなど）を目的としている場合、"textAutoCorrect" 値を使用して自動スペル修正を有効にすることです。

android:inputType 属性で、さまざまな動作と入力方法のスタイルを組み合わせることができます。たとえば、文の最初の単語を大文字にし、スペルミスを自動修正するテキストフィールドの作成方法は次のとおりです。

<EditText
    android:id="@+id/message"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:inputType=
        "textCapSentences|textAutoCorrect"
    ... />

入力方法のアクションの指定

ほとんどのソフト入力方法では、現在のテキストフィールドに適したユーザーアクションボタンが下隅にあります。デフォルトでは、テキストフィールドで複数行テキストが（android:inputType="textMultiLine" などで）許可されている場合を除き、システムはこのボタンを Next または Done アクションに使用します。複数行テキストが許可されている場合、アクションボタンは改行です。ただし、Send や Go など、テキストフィールドにより適した別のアクションを指定できます。

キーボードアクションボタンを指定するには、android:imeOptions 属性値を使用して "actionSend" または "actionSearch" などのアクション値を指定します。次に例を示します。

送信ボタン — **図 4.** `android:imeOptions="actionSend"` を宣言すると、[送信] ボタンが表示されます。

<EditText
    android:id="@+id/search"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:hint="@string/search_hint"
    android:inputType="text"
    android:imeOptions="actionSend" />

その後、EditText 要素の TextView.OnEditorActionListener を定義することで、アクションボタンの押下をリッスンできます。次の例に示すように、リスナーで、EditorInfo クラスで定義された適切な IME アクション ID（IME_ACTION_SEND など）に応答します。

Kotlin

findViewById<EditText>(R.id.search).setOnEditorActionListener { v, actionId, event ->
    return@setOnEditorActionListener when (actionId) {
        EditorInfo.IME_ACTION_SEND -> {
            sendMessage()
            true
        }
        else -> false
    }
}

Java

EditText editText = (EditText) findViewById(R.id.search);
editText.setOnEditorActionListener(new OnEditorActionListener() {
    @Override
    public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {
        boolean handled = false;
        if (actionId == EditorInfo.IME_ACTION_SEND) {
            sendMessage();
            handled = true;
        }
        return handled;
    }
});

オートコンプリート候補の提供

入力時に候補を提供する場合は、AutoCompleteTextView という EditText のサブクラスを使用できます。オートコンプリートを実装するには、テキストの候補を提供する Adapter を指定する必要があります。データの送信元（データベースやアレイなど）に応じて、いくつかのアダプタを使用できます。

**図 5.** テキスト候補を表示する `AutoCompleteTextView` の例。

次の手順では、ArrayAdapter を使用して、配列から候補を提供する AutoCompleteTextView を設定する方法について説明します。

AutoCompleteTextView をレイアウトに追加します。テキストフィールドのみのレイアウトは次のとおりです。

<?xml version="1.0" encoding="utf-8"?>
<AutoCompleteTextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/autocomplete_country"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content" />

すべてのテキスト候補を含む配列を定義します。たとえば、国名の配列は次のとおりです。

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="countries_array">
        <item>Afghanistan</item>
        <item>Albania</item>
        <item>Algeria</item>
        <item>American Samoa</item>
        <item>Andorra</item>
        <item>Angola</item>
        <item>Anguilla</item>
        <item>Antarctica</item>
        ...
    </string-array>
</resources>

Activity または Fragment で、次のコードを使用して、候補を提供するアダプターを指定します。

Kotlin

// Get a reference to the AutoCompleteTextView in the layout.
val textView = findViewById(R.id.autocomplete_country) as AutoCompleteTextView
// Get the string array.
val countries: Array<out String> = resources.getStringArray(R.array.countries_array)
// Create the adapter and set it to the AutoCompleteTextView.
ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, countries).also { adapter ->
    textView.setAdapter(adapter)
}

Java

// Get a reference to the AutoCompleteTextView in the layout.
AutoCompleteTextView textView = (AutoCompleteTextView) findViewById(R.id.autocomplete_country);
// Get the string array.
String[] countries = getResources().getStringArray(R.array.countries_array);
// Create the adapter and set it to the AutoCompleteTextView.
ArrayAdapter<String> adapter =
        new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, countries);
textView.setAdapter(adapter);

上記の例では、新しい ArrayAdapter が初期化されて、countries_array 文字列配列の各アイテムが、simple_list_item_1 レイアウトに存在する TextView にバインドされます。これは、リスト内のテキストに標準の外観を提供する Android 提供のレイアウトです。

setAdapter() を呼び出して、アダプターを AutoCompleteTextView に割り当てます。

入力方法のタイプを指定する

キーボード タイプの指定

スペルの候補と他の動作の有効化

入力方法のアクションの指定

Kotlin

Java

オートコンプリート候補の提供

Kotlin

Java

キーボードタイプの指定