Учебное пособие по примерам Android AutoCompleteTextView

AutocompleteTextView — это редактируемое текстовое представление, которое автоматически отображает предложения по завершению, пока пользователь печатает в приложениях для Android. В этом руководстве мы реализуем Android AutoCompleteTextView в нашем приложении, используя ArrayAdapter для определения списка предложений.

Обзор Android AutoCompleteTextView

AutoCompleteTextView — это компонент, используемый для отображения предложений при написании в редактируемом текстовом поле. Список предложений отображается в раскрывающемся меню, из которого пользователь может выбрать нужный элемент. Список предложений получается от адаптера и появляется только после того количества символов, которое указано в пороге. Чтобы использовать поле AutoCompleteThreshold, его необходимо определить в макете xml следующим образом:

<AutoCompleteTextView
   android:id="@+id/autoCompleteTextView"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_alignParentTop="true"
   android:layout_centerHorizontal="true"
   android:layout_marginTop="65dp"
   android:ems="10" >

Примечание. android:ems или setEms(x) устанавливает ширину TextView, чтобы она соответствовала тексту, состоящему из x M букв, независимо от фактического расширения текста и размера текста. Некоторые важные методы списка автозаполнения приведены ниже:

1. getAdapter(): этот метод возвращает фильтруемый адаптер списка, используемый для автоматического завершения.
2. getCompletionHint(): этот метод возвращает необязательный текст подсказки, отображаемый в нижней части списка соответствия.
3. getDropDownAnchor(): этот метод возвращает идентификатор представления, к которому прикреплен раскрывающийся список автозаполнения.
4. getListSelection(): этот метод возвращает позицию выбора раскрывающегося списка, если таковая имеется.
5. isPopupShowing(): этот метод указывает, отображается ли всплывающее меню.
6. setText(CharSequence text, boolean filter): этот метод задает текст, но может отключить фильтрацию
7. showDropDown(): этот метод отображает раскрывающийся список на экране.

Метод setAdapter используется для установки адаптера autoCompleteTextView. Давайте перейдем к части кодирования.

Структура проекта Android AutoCompleteTextView

Пример кода Android AutoCompleteTextView

Макет MainActivity определяется следующим образом. activity_main.xml

<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools" android:layout_width="match_parent"
    android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_alignParentTop="true"
        android:layout_marginTop="15dp"
        android:text="Name a fruit from (Apple Banana Cherry Date Grape Kiwi Mango Pear)" />

    <AutoCompleteTextView
        android:id="@+id/autoCompleteTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_below="@+id/textView"
        android:layout_marginLeft="36dp"
        android:layout_marginTop="17dp"
        android:ems="10"
        android:text="">

        <requestFocus />
    </AutoCompleteTextView>

</RelativeLayout>

MainActivity.java определен ниже.

package com.journaldev.autocomplete;

import android.app.Activity;
import android.graphics.Color;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;

public class MainActivity extends Activity {
    String[] fruits = {"Apple", "Banana", "Cherry", "Date", "Grape", "Kiwi", "Mango", "Pear"};

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        //Creating the instance of ArrayAdapter containing list of fruit names
        ArrayAdapter<String> adapter = new ArrayAdapter<String>
                (this, android.R.layout.select_dialog_item, fruits);
        //Getting the instance of AutoCompleteTextView
        AutoCompleteTextView actv = (AutoCompleteTextView) findViewById(R.id.autoCompleteTextView);
        actv.setThreshold(1);//will start working from first character
        actv.setAdapter(adapter);//setting the adapter data into the AutoCompleteTextView
        actv.setTextColor(Color.RED);

    }
}

Скачать проект Android AutoCompleteTextView