Android - Controle AutoCompleteTextView
Um AutoCompleteTextView é uma visualização semelhante a EditText, exceto que mostra uma lista de sugestões de conclusão automaticamente enquanto o usuário está digitando.
A lista de sugestões é exibida no menu suspenso. O usuário pode escolher um item para substituir o conteúdo da caixa de edição.
Atributos AutoCompleteTextView
A seguir estão os atributos importantes relacionados ao controle AutoCompleteTextView. Você pode verificar a documentação oficial do Android para uma lista completa de atributos e métodos relacionados que você pode usar para alterar esses atributos em tempo de execução.
Sr. Não | Atributo e descrição |
---|---|
1 | android:completionHint Isso define a dica exibida no menu suspenso. |
2 | android:completionHintView Isso define a visualização de dica exibida no menu suspenso. |
3 | android:completionThreshold Isso define o número de caracteres que o usuário deve digitar antes que as sugestões de conclusão sejam exibidas em um menu suspenso. |
4 | android:dropDownAnchor Esta é a Visualização para ancorar o menu suspenso de preenchimento automático. |
5 | android:dropDownHeight Isso especifica a altura básica do menu suspenso. |
6 | android:dropDownHorizontalOffset A quantidade de pixels pela qual o menu suspenso deve ser deslocado horizontalmente. |
7 | android:dropDownSelector Este é o seletor em uma lista suspensa. |
8 | android:dropDownVerticalOffset A quantidade de pixels pela qual a lista suspensa deve ser deslocada verticalmente. |
9 | android:dropDownWidth Isso especifica a largura básica da lista suspensa. |
10 | android:popupBackground Isso define o plano de fundo. |
Exemplo
Este exemplo o levará por etapas simples para mostrar como criar seu próprio aplicativo Android usando Layout Linear e AutoCompleteTextView.
Degrau | Descrição |
---|---|
1 | Você usará o Android Studio IDE para criar um aplicativo Android e nomeá-lo como GUIDemo3 no pacote com.example.guidemo3 conforme explicado no capítulo Exemplo Hello World . |
2 | Modifique o arquivo src / MainActivity.java para adicionar um evento de clique. |
3 | Modifique o conteúdo padrão do arquivo res / layout / activity_main.xml para incluir o controle de IU do Android. |
4 | Defina as constantes necessárias no arquivo res / values / strings.xml |
5 | Execute o aplicativo para iniciar o emulador Android e verifique o resultado das alterações feitas no aplicativo. |
A seguir está o conteúdo do arquivo de atividade principal modificado src/com.example.guidemo3/MainActivity.java. Este arquivo pode incluir cada um dos métodos fundamentais do ciclo de vida.
package com.example.guidemo3;
import android.os.Bundle;
import android.app.Activity;
import android.view.Menu;
import android.widget.ArrayAdapter;
import android.widget.AutoCompleteTextView;
public class MainActivity extends Activity {
AutoCompleteTextView autocomplete;
String[] arr = { "Paries,France", "PA,United States","Parana,Brazil",
"Padua,Italy", "Pasadena,CA,United States"};
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
autocomplete = (AutoCompleteTextView)
findViewById(R.id.autoCompleteTextView1);
ArrayAdapter<String> adapter = new ArrayAdapter<String>
(this,android.R.layout.select_dialog_item, arr);
autocomplete.setThreshold(2);
autocomplete.setAdapter(adapter);
}
}
A seguir estará o conteúdo de res/layout/activity_main.xml arquivo -
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context=".MainActivity" >
<TextView
android:id="@+id/textView2"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentTop="true"
android:layout_centerHorizontal="true"
android:layout_marginTop="25dp"
android:text="@string/example_autocompletetextview" />
<AutoCompleteTextView
android:id="@+id/autoCompleteTextView1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignLeft="@+id/textView2"
android:layout_below="@+id/textView2"
android:layout_marginTop="54dp"
android:ems="10" />
</RelativeLayout>
A seguir estará o conteúdo de res/values/strings.xml para definir essas novas constantes -
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name">GUIDemo3</string>
<string name="example_autocompletetextview">Example showing AutoCompleteTextView<
/string>
</resources>
A seguir está o conteúdo padrão de AndroidManifest.xml -
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.guidemo3" >
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="com.example.guidemo3.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
Vamos tentar executar o seu GUIDemo3inscrição. Suponho que você tenha criado o seuAVDao fazer a configuração do ambiente. Para executar o aplicativo no Android Studio, abra um dos arquivos de atividade do seu projeto e clique no ícone Executar na barra de ferramentas. O Android Studio instala o aplicativo em seu AVD e o inicia e se tudo estiver bem com sua configuração e aplicativo, ele será exibido a seguir a janela do emulador -
A tela a seguir aparecerá após "pa" ser digitado em AutoCompleteTextView -
Exercício
Recomendarei experimentar o exemplo acima com diferentes atributos de AutoCompleteTextView no arquivo XML de Layout, bem como em tempo de programação para ter uma aparência diferente do AutoCompleteTextView. Tente torná-lo editável, mude para a cor da fonte, família da fonte, largura, tamanho do texto etc e veja o resultado. Você também pode tentar o exemplo acima com vários controles AutoCompleteTextView em uma atividade.