Android(安卓)AutoCompleteTextView 控件
AutoCompleteTextView 是一种与 EditText 类似的视图,只是它在用户键入时自动显示完成建议列表。
建议列表显示在下拉菜单中。用户可以从中选择一个项目以替换编辑框的内容。
AutoCompleteTextView 属性
以下是与 AutoCompleteTextView 控件相关的重要属性。您可以查看Android官方文档,以获取完整的属性列表和可用于更改这些属性的相关方法。
| 编号 | 属性 & 描述 |
|---|---|
| 1 | android:completionHint 定义了下拉菜单中显示的提示。 |
| 2 | android:completionHintView 定义了下拉菜单中显示的提示视图。 |
| 3 | android:completionThreshold 这定义了用户在下拉菜单中显示完成建议之前必须输入的字符数。 |
| 4 | android:dropDownAnchor 将自动完成下拉列表锚定到的视图。 |
| 5 | android:dropDownHeight 指定了下拉列表的基本高度。 |
| 6 | android:dropDownHorizontalOffset 下拉框应水平偏移的像素数。 |
| 7 | android:dropDownSelector 下拉列表中的选择器。 |
| 8 | android:dropDownVerticalOffset 下拉框应垂直偏移的像素数。 |
| 9 | android:dropDownWidth 指定了下拉列表的基本宽度。 |
| 10 | android:popupBackground 设置背景。 |
实例
这个实例将带您完成简单的步骤,展示如何使用线性布局和 AutoCompleteTextView 创建自己的 Android 应用程序。
| 步骤 | 描述 |
|---|---|
| 1 | 您将使用 Android Studio IDE 创建一个 Android 应用程序,并将其命名为 com.example.guidemo3 包下的 GUIDemo3,如Hello World示例一章中所述 |
| 2 | 修改 src/MainActivity.java 文件来添加一个点击事件。 |
| 3 | 修改 res/layout/activity_main.xml 文件默认内容来包含 Android UI 控件。 |
| 4 | 在 res/values/strings.xml 文件中定义必要得常量。 |
| 5 | 运行应用程序以启动 Android 模拟器并验证应用程序中所做更改的结果。 |
下面是修改后的主活动文件 src/com.example.guidemo3/MainActivity.java 的内容。该文件可以包括每个基本的生命周期方法。
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"};@Overrideprotected 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);}}
下面是 res/layout/activity_main.xml 文件的内容:
<?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" ><TextViewandroid: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" /><AutoCompleteTextViewandroid: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>
下面是 res/values/strings.xml 文件的内容,定义了两个常量
<?xml version="1.0" encoding="utf-8"?><resources><string name="app_name">GUIDemo3</string><string name="example_autocompletetextview">Example showing AutoCompleteTextView</string></resources>
下面是 AndroidManifest.xml 文件的默认内容:
<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.example.guidemo3" ><applicationandroid:allowBackup="true"android:icon="@drawable/ic_launcher"android:label="@string/app_name"android:theme="@style/AppTheme" ><activityandroid: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>
让我们尝试运行 GUIDemo3 应用程序。我假设您在进行环境设置时创建了 AVD。要从 Android Studio 运行应用程序,请打开项目的 activity 文件之一,然后单击工具栏上的运行 Eclipse
图标。Android studio 在您的 AVD 上安装应用程序并启动它,如果您的设置和应用程序一切正常,它将显示以下模拟器窗口:
在 AutoCompleteTextView 中输入 "pa" 后将出现以下屏幕:

练习
建议在编程时使用布局 XML 文件中的 AutoCompleteTextView 的不同属性来尝试上面的示例,以使 AutoCompleteTextView 具有不同的外观。尝试使其可编辑,更改为字体颜色、字体系列、宽度、文本大小等,然后查看结果。您也可以在一个活动中使用多个 AutoCompleteTextView 控件来尝试上面的示例。