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"};
@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);
}
}
下面是 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" >
<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>
下面是 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" >
<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>
让我们尝试运行 GUIDemo3 应用程序。我假设您在进行环境设置时创建了 AVD。要从 Android Studio 运行应用程序,请打开项目的 activity 文件之一,然后单击工具栏上的运行 Eclipse 图标。Android studio 在您的 AVD 上安装应用程序并启动它,如果您的设置和应用程序一切正常,它将显示以下模拟器窗口:
在 AutoCompleteTextView 中输入 "pa" 后将出现以下屏幕:
练习
建议在编程时使用布局 XML 文件中的 AutoCompleteTextView 的不同属性来尝试上面的示例,以使 AutoCompleteTextView 具有不同的外观。尝试使其可编辑,更改为字体颜色、字体系列、宽度、文本大小等,然后查看结果。您也可以在一个活动中使用多个 AutoCompleteTextView 控件来尝试上面的示例。