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 控件。
4res/values/strings.xml 文件中定义必要得常量。
5运行应用程序以启动 Android 模拟器并验证应用程序中所做更改的结果。

下面是修改后的主活动文件 src/com.example.guidemo3/MainActivity.java 的内容。该文件可以包括每个基本的生命周期方法。

  1. package com.example.guidemo3;
  2. import android.os.Bundle;
  3. import android.app.Activity;
  4. import android.view.Menu;
  5. import android.widget.ArrayAdapter;
  6. import android.widget.AutoCompleteTextView;
  7. public class MainActivity extends Activity {
  8. AutoCompleteTextView autocomplete;
  9. String[] arr = { "Paries,France", "PA,United States","Parana,Brazil",
  10. "Padua,Italy", "Pasadena,CA,United States"};
  11. @Override
  12. protected void onCreate(Bundle savedInstanceState) {
  13. super.onCreate(savedInstanceState);
  14. setContentView(R.layout.activity_main);
  15. autocomplete = (AutoCompleteTextView)
  16. findViewById(R.id.autoCompleteTextView1);
  17. ArrayAdapter<String> adapter = new ArrayAdapter<String>
  18. (this,android.R.layout.select_dialog_item, arr);
  19. autocomplete.setThreshold(2);
  20. autocomplete.setAdapter(adapter);
  21. }
  22. }

下面是 res/layout/activity_main.xml 文件的内容:

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3. xmlns:tools="http://schemas.android.com/tools"
  4. android:layout_width="match_parent"
  5. android:layout_height="match_parent"
  6. android:paddingBottom="@dimen/activity_vertical_margin"
  7. android:paddingLeft="@dimen/activity_horizontal_margin"
  8. android:paddingRight="@dimen/activity_horizontal_margin"
  9. android:paddingTop="@dimen/activity_vertical_margin"
  10. tools:context=".MainActivity" >
  11. <TextView
  12. android:id="@+id/textView2"
  13. android:layout_width="wrap_content"
  14. android:layout_height="wrap_content"
  15. android:layout_alignParentTop="true"
  16. android:layout_centerHorizontal="true"
  17. android:layout_marginTop="25dp"
  18. android:text="@string/example_autocompletetextview" />
  19. <AutoCompleteTextView
  20. android:id="@+id/autoCompleteTextView1"
  21. android:layout_width="wrap_content"
  22. android:layout_height="wrap_content"
  23. android:layout_alignLeft="@+id/textView2"
  24. android:layout_below="@+id/textView2"
  25. android:layout_marginTop="54dp"
  26. android:ems="10" />
  27. </RelativeLayout>

下面是 res/values/strings.xml 文件的内容,定义了两个常量

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <resources>
  3. <string name="app_name">GUIDemo3</string>
  4. <string name="example_autocompletetextview">Example showing AutoCompleteTextView<
  5. /string>
  6. </resources>

下面是 AndroidManifest.xml 文件的默认内容:

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  3. package="com.example.guidemo3" >
  4. <application
  5. android:allowBackup="true"
  6. android:icon="@drawable/ic_launcher"
  7. android:label="@string/app_name"
  8. android:theme="@style/AppTheme" >
  9. <activity
  10. android:name="com.example.guidemo3.MainActivity"
  11. android:label="@string/app_name" >
  12. <intent-filter>
  13. <action android:name="android.intent.action.MAIN" />
  14. <category android:name="android.intent.category.LAUNCHER" />
  15. </intent-filter>
  16. </activity>
  17. </application>
  18. </manifest>

让我们尝试运行 GUIDemo3 应用程序。我假设您在进行环境设置时创建了 AVD。要从 Android Studio 运行应用程序,请打开项目的 activity 文件之一,然后单击工具栏上的运行 Eclipse Eclipse Run Icon 图标。Android studio 在您的 AVD 上安装应用程序并启动它,如果您的设置和应用程序一切正常,它将显示以下模拟器窗口:

在 AutoCompleteTextView 中输入 "pa" 后将出现以下屏幕:


练习

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

分类导航