Most visited

Recently visited

Added in API level 1

AutoCompleteTextView

public class AutoCompleteTextView
extends EditText implements Filter.FilterListener

java.lang.Object
   ↳ android.view.View
     ↳ android.widget.TextView
       ↳ android.widget.EditText
         ↳ android.widget.AutoCompleteTextView
Known Direct Subclasses
Known Indirect Subclasses


一个可编辑的文本视图,在用户输入时自动显示完成建议。 建议列表显示在一个下拉菜单中,用户可以从中选择一个项目来替换编辑框的内容。

可以随时按下返回键解除下拉菜单,或者,如果在下拉菜单中未选择任何项目,请按enter / dpad中心键。

建议列表是从数据适配器获得的,并且仅在 the threshold定义的给定数量的字符后出现。

以下代码片段显示了如何创建一个文本视图,该视图在用户输入时显示各个国家/地区的名称:

 public class CountriesActivity extends Activity {
     protected void onCreate(Bundle icicle) {
         super.onCreate(icicle);
         setContentView(R.layout.countries);

         ArrayAdapter<String> adapter = new ArrayAdapter<String>(this,
                 android.R.layout.simple_dropdown_item_1line, COUNTRIES);
         AutoCompleteTextView textView = (AutoCompleteTextView)
                 findViewById(R.id.countries_list);
         textView.setAdapter(adapter);
     }

     private static final String[] COUNTRIES = new String[] {
         "Belgium", "France", "Italy", "Germany", "Spain"
     };
 }
 

请参阅 Text Fields指南。

Summary

Nested classes

interface AutoCompleteTextView.OnDismissListener

监听器响应AutoCompleteTextView的完成列表被解散。

interface AutoCompleteTextView.Validator

该接口用于确保在此TextView中输入的文本符合特定的格式。

XML attributes

android:completionHint Defines the hint displayed in the drop down menu. 
android:completionHintView Defines the hint view displayed in the drop down menu. 
android:completionThreshold Defines the number of characters that the user must type before completion suggestions are displayed in a drop down menu. 
android:dropDownAnchor View to anchor the auto-complete dropdown to. 
android:dropDownHeight Specifies the basic height of the dropdown. 
android:dropDownHorizontalOffset Amount of pixels by which the drop down should be offset horizontally. 
android:dropDownSelector Selector in a drop down list. 
android:dropDownVerticalOffset Amount of pixels by which the drop down should be offset vertically. 
android:dropDownWidth Specifies the basic width of the dropdown. 
android:popupBackground The background to use for the popup window. 

Inherited XML attributes

From class android.widget.TextView
From class android.view.View

Inherited constants

From class android.view.View

Inherited fields

From class android.view.View

Public constructors

AutoCompleteTextView(Context context)

用给定的上下文主题构造一个新的自动完成文本视图。

AutoCompleteTextView(Context context, AttributeSet attrs)

使用给定的上下文主题和提供的属性集构造一个新的自动完成文本视图。

AutoCompleteTextView(Context context, AttributeSet attrs, int defStyleAttr)

使用给定的上下文主题,提供的属性集和默认样式属性构造一个新的自动完成文本视图。

AutoCompleteTextView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

使用给定的上下文主题,提供的属性集和默认样式构造一个新的自动完成文本视图。

AutoCompleteTextView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes, Resources.Theme popupTheme)

使用给定的上下文,提供的属性集,默认样式和完成弹出窗口应填充的主题构造一个新的自动完成文本视图。

Public methods

void clearListSelection()

清除列表选择。

void dismissDropDown()

如果出现在屏幕上,则关闭下拉菜单。

boolean enoughToFilter()

如果字段中的文本数量达到或超过 getThreshold()要求,则返回 true

ListAdapter getAdapter()

返回用于自动完成的可过滤列表适配器。

CharSequence getCompletionHint()

获取匹配列表底部显示的可选提示文本。

int getDropDownAnchor()

返回自动完成下拉列表所锚定到的视图的ID。

Drawable getDropDownBackground()

获取自动完成下拉列表的背景。

int getDropDownHeight()

返回自动完成下拉列表的当前高度。

int getDropDownHorizontalOffset()

获取用于自动完成下拉列表的水平偏移量。

int getDropDownVerticalOffset()

获取用于自动完成下拉列表的垂直偏移量。

int getDropDownWidth()

返回自动完成下拉列表的当前宽度。

AdapterView.OnItemClickListener getItemClickListener()

此方法在API级别3中已弃用。请使用getOnItemClickListener()

AdapterView.OnItemSelectedListener getItemSelectedListener()

此方法在API级别3中已弃用。请使用getOnItemSelectedListener()

int getListSelection()

获取下拉视图选择的位置,如果有的话。

AdapterView.OnItemClickListener getOnItemClickListener()

返回当用户单击下拉列表中的项目时通知的侦听器。

AdapterView.OnItemSelectedListener getOnItemSelectedListener()

返回用户在下拉列表中选择项目时通知的侦听器。

int getThreshold()

返回显示下拉列表之前用户必须键入的字符数。

AutoCompleteTextView.Validator getValidator()

如果未设置,则返回 setValidator(AutoCompleteTextView.Validator)null设置的验证器。

boolean isPerformingCompletion()

标识视图当前是否正在执行文本完成,因此子类可以决定是否响应文本更改的事件。

boolean isPopupShowing()

指示是否显示弹出式菜单。

void onCommitCompletion(CompletionInfo completion)

由框架调用,以响应当前输入方法的文本完成,由它提供,调用 InputConnection.commitCompletion()

void onFilterComplete(int count)

通知过滤操作结束。

boolean onKeyDown(int keyCode, KeyEvent event)

KeyEvent.Callback.onKeyDown()默认实现:当 KEYCODE_DPAD_CENTERKEYCODE_ENTER被释放时,如果视图已启用并且可点击,则执行按下视图。

boolean onKeyPreIme(int keyCode, KeyEvent event)

在关键事件由与视图层次关联的任何输入方法处理之前处理。

boolean onKeyUp(int keyCode, KeyEvent event)

的默认实现 KeyEvent.Callback.onKeyUp() :当视图进行点击 KEYCODE_DPAD_CENTERKEYCODE_ENTER或者 KEYCODE_SPACE被释放。

void onWindowFocusChanged(boolean hasWindowFocus)

当包含此视图的窗口获得或失去焦点时调用。

void performCompletion()

通过将所选项从下拉列表转换为字符串来执行文本完成,用该字符串替换文本框的内容,最后解除下拉菜单。

void performValidation()

如果在此视图上设置了验证程序并且当前字符串无效,请验证程序修复它。

<T extends ListAdapter & Filterable> void setAdapter(T adapter)

更改用于自动完成的数据列表。

void setCompletionHint(CharSequence hint)

设置匹配列表底部显示的可选提示文本。

void setDropDownAnchor(int id)

设置自动完成下拉列表应该锚定的视图。

void setDropDownBackgroundDrawable(Drawable d)

设置自动完成下拉列表的背景。

void setDropDownBackgroundResource(int id)

设置自动完成下拉列表的背景。

void setDropDownHeight(int height)

设置自动完成下拉列表的当前高度。

void setDropDownHorizontalOffset(int offset)

设置用于自动完成下拉列表的水平偏移量。

void setDropDownVerticalOffset(int offset)

设置用于自动完成下拉列表的垂直偏移量。

void setDropDownWidth(int width)

设置自动完成下拉列表的当前宽度。

void setListSelection(int position)

设置下拉视图选择的位置。

void setOnClickListener(View.OnClickListener listener)

单击此视图时注册要调用的回调。

void setOnDismissListener(AutoCompleteTextView.OnDismissListener dismissListener)

设置一个侦听器,只要AutoCompleteTextView的完成列表被取消就会被调用。

void setOnItemClickListener(AdapterView.OnItemClickListener l)

设置在用户单击下拉列表中的项目时将收到通知的侦听器。

void setOnItemSelectedListener(AdapterView.OnItemSelectedListener l)

设置在用户选择下拉列表中的项目时将收到通知的侦听器。

void setText(CharSequence text, boolean filter)

setText(CharSequence)一样,除了它可以禁用过滤。

void setThreshold(int threshold)

指定显示下拉列表之前,用户必须在编辑框中键入的最少字符数。

void setValidator(AutoCompleteTextView.Validator validator)

设置用于执行文本验证的验证程序。

void showDropDown()

在屏幕上显示下拉菜单。

Protected methods

CharSequence convertSelectionToString(Object selectedItem)

将所选项目从下拉列表转换为可在编辑框中使用的字符序列。

Filter getFilter()

如果 setAdapter(T)未用可筛选方式调用,则返回从 getFilter()null获取的筛选器。

void onAttachedToWindow()

这在视图附加到窗口时被调用。

void onDetachedFromWindow()

这是在视图从窗口分离时调用的。

void onDisplayHint(int hint)

给出这个观点暗示是否显示。

void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect)

当视图的焦点状态改变时,由视图系统调用。

void performFiltering(CharSequence text, int keyCode)

开始过滤下拉列表的内容。

void replaceText(CharSequence text)

通过用所选项目替换当前文本来执行文本完成。

boolean setFrame(int l, int t, int r, int b)

为此视图分配大小和位置。

Inherited methods

From class android.widget.EditText
From class android.widget.TextView
From class android.view.View
From class java.lang.Object
From interface android.view.ViewTreeObserver.OnPreDrawListener
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource
From interface android.widget.Filter.FilterListener

XML attributes

android:completionHint

定义下拉菜单中显示的提示。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的引用。

这对应于全局属性资源符号 completionHint

相关方法:

android:completionHintView

定义显示在下拉菜单中的提示视图。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 completionHintView

android:completionThreshold

定义在下拉菜单中显示完成建议之前用户必须键入的字符数。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的引用。

这对应于全局属性资源符号 completionThreshold

相关方法:

android:dropDownAnchor

查看将自动完成下拉列表固定到。 如果未指定,则使用文本视图本身。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 dropDownAnchor

相关方法:

android:dropDownHeight

指定下拉的基本高度。 它的值可以是一个维数(例如“12dip”),fill_parent或match_parent填充屏幕的高度,wrap_content可以匹配下拉内容的高度。

可能是一个维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的引用。

可能是以下常数值之一。

Constant Value 描述
fill_parent -1 The dropdown should fit the height of the screen. This constant is deprecated starting from API Level 8 and is replaced by match_parent.
match_parent -1 The dropdown should fit the height of the screen. Introduced in API Level 8.
wrap_content -2 The dropdown should fit the height of the content.

这对应于全局属性资源符号 dropDownHeight

相关方法:

android:dropDownHorizontalOffset

下拉应该水平偏移的像素数量。

必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可以是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的引用。

这对应于全局属性资源符号 dropDownHorizontalOffset

相关方法:

android:dropDownSelector

选择器在下拉列表中。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 dropDownSelector

android:dropDownVerticalOffset

下拉应该垂直偏移的像素数量。

必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的引用。

这对应于全局属性资源符号 dropDownVerticalOffset

相关方法:

android:dropDownWidth

指定下拉的基本宽度。 其值可以是用于固定宽度的维度(例如“12dip”),fill_parent或match_parent以匹配屏幕宽度,或者wrap_content用于匹配锚定视图的宽度。

可能是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的引用。

可能是以下常数值之一。

Constant Value 描述
fill_parent -1 The dropdown should fill the width of the screen. This constant is deprecated starting from API Level 8 and is replaced by match_parent.
match_parent -1 The dropdown should fit the width of the screen. Introduced in API Level 8.
wrap_content -2 The dropdown should fit the width of its anchor.

这对应于全局属性资源符号 dropDownWidth

相关方法:

android:popupBackground

用于弹出窗口的背景。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 popupBackground

相关方法:

Public constructors

AutoCompleteTextView

Added in API level 1
AutoCompleteTextView (Context context)

用给定的上下文主题构造一个新的自动完成文本视图。

Parameters
context Context: The Context the view is running in, through which it can access the current theme, resources, etc.

AutoCompleteTextView

Added in API level 1
AutoCompleteTextView (Context context, 
                AttributeSet attrs)

使用给定的上下文主题和提供的属性集构造一个新的自动完成文本视图。

Parameters
context Context: The Context the view is running in, through which it can access the current theme, resources, etc.
attrs AttributeSet: The attributes of the XML tag that is inflating the view.

AutoCompleteTextView

Added in API level 1
AutoCompleteTextView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

使用给定的上下文主题,提供的属性集和默认样式属性构造一个新的自动完成文本视图。

Parameters
context Context: The Context the view is running in, through which it can access the current theme, resources, etc.
attrs AttributeSet: The attributes of the XML tag that is inflating the view.
defStyleAttr int: An attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.

AutoCompleteTextView

Added in API level 21
AutoCompleteTextView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

使用给定的上下文主题,提供的属性集和默认样式构造一个新的自动完成文本视图。

Parameters
context Context: The Context the view is running in, through which it can access the current theme, resources, etc.
attrs AttributeSet: The attributes of the XML tag that is inflating the view.
defStyleAttr int: An attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.
defStyleRes int: A resource identifier of a style resource that supplies default values for the view, used only if defStyleAttr is 0 or can not be found in the theme. Can be 0 to not look for defaults.

AutoCompleteTextView

Added in API level 24
AutoCompleteTextView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes, 
                Resources.Theme popupTheme)

使用给定的上下文,提供的属性集,默认样式和完成弹出窗口应填充的主题构造一个新的自动完成文本视图。

Parameters
context Context: The context against which the view is inflated, which provides access to the current theme, resources, etc.
attrs AttributeSet: The attributes of the XML tag that is inflating the view.
defStyleAttr int: An attribute in the current theme that contains a reference to a style resource that supplies default values for the view. Can be 0 to not look for defaults.
defStyleRes int: A resource identifier of a style resource that supplies default values for the view, used only if defStyleAttr is 0 or can not be found in the theme. Can be 0 to not look for defaults.
popupTheme Resources.Theme: The theme against which the completion popup window should be inflated. May be null to use the view theme. If set, this will override any value specified by AutoCompleteTextView_popupTheme.

Public methods

clearListSelection

Added in API level 3
void clearListSelection ()

清除列表选择。 这可能只是暂时的,因为用户输入通常会把它带回来。

dismissDropDown

Added in API level 1
void dismissDropDown ()

如果出现在屏幕上,则关闭下拉菜单。

enoughToFilter

Added in API level 1
boolean enoughToFilter ()

如果字段中的文本数量达到或超过getThreshold()要求,则返回true 您可以覆盖此设置,以便在触发过滤时施加不同的标准。

Returns
boolean

getAdapter

Added in API level 1
ListAdapter getAdapter ()

返回用于自动完成的可过滤列表适配器。

Returns
ListAdapter a data adapter used for auto completion

getCompletionHint

Added in API level 16
CharSequence getCompletionHint ()

获取匹配列表底部显示的可选提示文本。

相关XML属性:

Returns
CharSequence The hint text, if any

也可以看看:

getDropDownAnchor

Added in API level 3
int getDropDownAnchor ()

返回自动完成下拉列表所锚定到的视图的ID。

相关XML属性:

Returns
int the view's id, or NO_ID if none specified

getDropDownBackground

Added in API level 5
Drawable getDropDownBackground ()

获取自动完成下拉列表的背景。

相关XML属性:

Returns
Drawable the background drawable

getDropDownHeight

Added in API level 4
int getDropDownHeight ()

返回自动完成下拉列表的当前高度。 这可以是一个固定的高度,或MATCH_PARENT来填充屏幕,或WRAP_CONTENT以适应下拉内容的高度。

相关XML属性:

Returns
int the height for the drop down list

getDropDownHorizontalOffset

Added in API level 5
int getDropDownHorizontalOffset ()

获取用于自动完成下拉列表的水平偏移量。

相关XML属性:

Returns
int the horizontal offset

getDropDownVerticalOffset

Added in API level 5
int getDropDownVerticalOffset ()

获取用于自动完成下拉列表的垂直偏移量。

相关XML属性:

Returns
int the vertical offset

getDropDownWidth

Added in API level 3
int getDropDownWidth ()

返回自动完成下拉列表的当前宽度。 这可以是一个固定的宽度,或MATCH_PARENT来填充屏幕,或WRAP_CONTENT以适合其锚点视图的宽度。

相关XML属性:

Returns
int the width for the drop down list

getItemClickListener

Added in API level 1
AdapterView.OnItemClickListener getItemClickListener ()

此方法在API级别3中已被弃用。
使用getOnItemClickListener() intead

返回当用户单击下拉列表中的项目时通知的侦听器。

Returns
AdapterView.OnItemClickListener the item click listener

getItemSelectedListener

Added in API level 1
AdapterView.OnItemSelectedListener getItemSelectedListener ()

此方法在API级别3中已被弃用。
使用getOnItemSelectedListener() intead

返回用户在下拉列表中选择项目时通知的侦听器。

Returns
AdapterView.OnItemSelectedListener the item selected listener

getListSelection

Added in API level 3
int getListSelection ()

获取下拉视图选择的位置,如果有的话。 如果没有下拉菜单或没有选择,则返回ListView.INVALID_POSITION

Returns
int the position of the current selection, if there is one, or ListView.INVALID_POSITION if not.

也可以看看:

getOnItemClickListener

Added in API level 3
AdapterView.OnItemClickListener getOnItemClickListener ()

返回当用户单击下拉列表中的项目时通知的侦听器。

Returns
AdapterView.OnItemClickListener the item click listener

getOnItemSelectedListener

Added in API level 3
AdapterView.OnItemSelectedListener getOnItemSelectedListener ()

返回用户在下拉列表中选择项目时通知的侦听器。

Returns
AdapterView.OnItemSelectedListener the item selected listener

getThreshold

Added in API level 1
int getThreshold ()

返回显示下拉列表之前用户必须键入的字符数。

相关XML属性:

Returns
int the minimum number of characters to type to show the drop down

也可以看看:

getValidator

Added in API level 1
AutoCompleteTextView.Validator getValidator ()

如果未设置,则返回设置为 setValidator(AutoCompleteTextView.Validator)null的验证器。

Returns
AutoCompleteTextView.Validator

也可以看看:

isPerformingCompletion

Added in API level 3
boolean isPerformingCompletion ()

标识视图当前是否正在执行文本完成,因此子类可以决定是否响应文本更改的事件。

Returns
boolean

isPopupShowing

Added in API level 1
boolean isPopupShowing ()

指示是否显示弹出式菜单。

Returns
boolean true if the popup menu is showing, false otherwise

onCommitCompletion

Added in API level 3
void onCommitCompletion (CompletionInfo completion)

由框架调用以响应当前输入方法的文本完成,由其提供,调用InputConnection.commitCompletion() 默认实现什么也不做; 支持自动完成的文本视图应该重写此操作以执行其所需的行为。

Parameters
completion CompletionInfo: The auto complete text the user has selected.

onFilterComplete

Added in API level 1
void onFilterComplete (int count)

通知过滤操作结束。

Parameters
count int: the number of values computed by the filter

onKeyDown

Added in API level 1
boolean onKeyDown (int keyCode, 
                KeyEvent event)

KeyEvent.Callback.onKeyDown()默认实现:当 KEYCODE_DPAD_CENTERKEYCODE_ENTER被释放时,如果视图已启用并且可点击,则执行按下视图。

软件键盘中的按键通常不会触发这个监听器,尽管在某些情况下有些人会选择这样做。 不要依靠这个来捕捉软件按键。

Parameters
keyCode int: a key code that represents the button pressed, from KeyEvent
event KeyEvent: the KeyEvent object that defines the button action
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyPreIme

Added in API level 3
boolean onKeyPreIme (int keyCode, 
                KeyEvent event)

在关键事件由与视图层次关联的任何输入方法处理之前处理。 这可以用于在IME消耗它们之前在特殊情况下截获关键事件; 一个典型的例子是处理BACK键来更新应用程序的UI,而不是让IME看到它并关闭它自己。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyUp

Added in API level 1
boolean onKeyUp (int keyCode, 
                KeyEvent event)

的默认实现 KeyEvent.Callback.onKeyUp() :当视图进行点击 KEYCODE_DPAD_CENTERKEYCODE_ENTER或者 KEYCODE_SPACE被释放。

软件键盘中的按键通常不会触发这个监听器,尽管在某些情况下有些人会选择这样做。 不要依靠这个来捕捉软件按键。

Parameters
keyCode int: A key code that represents the button pressed, from KeyEvent.
event KeyEvent: The KeyEvent object that defines the button action.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onWindowFocusChanged

Added in API level 1
void onWindowFocusChanged (boolean hasWindowFocus)

当包含此视图的窗口获得或失去焦点时调用。 请注意,这与视图焦点不同:要接收关键事件,视图和其窗口都必须具有焦点。 如果一个窗口显示在需要输入焦点的窗口上,那么您自己的窗口将失去焦点,但视图焦点将保持不变。

Parameters
hasWindowFocus boolean: True if the window containing this view now has focus, false otherwise.

performCompletion

Added in API level 1
void performCompletion ()

通过将所选项从下拉列表转换为字符串来执行文本完成,用该字符串替换文本框的内容,最后解除下拉菜单。

performValidation

Added in API level 1
void performValidation ()

如果在此视图上设置了验证程序并且当前字符串无效,请验证程序修复它。

也可以看看:

setAdapter

Added in API level 1
void setAdapter (T adapter)

更改用于自动完成的数据列表。 提供的列表必须是可过滤的列表适配器。

调用者仍负责管理适配器使用的任何资源。 值得注意的是,当AutoCompleteTextView被关闭或释放时,适配器不会被通知。 常见的情况是使用CursorAdapter ,其中包含必须关闭的Cursor 这可以自动完成(请参阅startManagingCursor() ),或者在AutoCompleteTextView关闭时手动关闭游标。

Parameters
adapter T: the adapter holding the auto completion data

也可以看看:

setCompletionHint

Added in API level 1
void setCompletionHint (CharSequence hint)

设置匹配列表底部显示的可选提示文本。 这可以作为提示用户如何最好地使用列表或提供额外信息。

相关XML属性:

Parameters
hint CharSequence: the text to be displayed to the user

也可以看看:

setDropDownAnchor

Added in API level 3
void setDropDownAnchor (int id)

设置自动完成下拉列表应该锚定的视图。 直到下一次需要避免加载尚未实例化的视图时,才会加载与此id相对应的视图。

相关XML属性:

Parameters
id int: the id to anchor the drop down list view to

setDropDownBackgroundDrawable

Added in API level 5
void setDropDownBackgroundDrawable (Drawable d)

设置自动完成下拉列表的背景。

相关XML属性:

Parameters
d Drawable: the drawable to set as the background

setDropDownBackgroundResource

Added in API level 5
void setDropDownBackgroundResource (int id)

设置自动完成下拉列表的背景。

相关XML属性:

Parameters
id int: the id of the drawable to set as the background

setDropDownHeight

Added in API level 4
void setDropDownHeight (int height)

设置自动完成下拉列表的当前高度。 这可以是一个固定的高度,或MATCH_PARENT来填充屏幕,或WRAP_CONTENT以适应下拉内容的高度。

相关XML属性:

Parameters
height int: the height to use

setDropDownHorizontalOffset

Added in API level 5
void setDropDownHorizontalOffset (int offset)

设置用于自动完成下拉列表的水平偏移量。

相关XML属性:

Parameters
offset int: the horizontal offset

setDropDownVerticalOffset

Added in API level 5
void setDropDownVerticalOffset (int offset)

设置用于自动完成下拉列表的垂直偏移量。

相关XML属性:

Parameters
offset int: the vertical offset

setDropDownWidth

Added in API level 3
void setDropDownWidth (int width)

设置自动完成下拉列表的当前宽度。 这可以是一个固定的宽度,或MATCH_PARENT来填充屏幕,或WRAP_CONTENT以适应其锚点视图的宽度。

相关XML属性:

Parameters
width int: the width to use

setListSelection

Added in API level 3
void setListSelection (int position)

设置下拉视图选择的位置。

Parameters
position int: The position to move the selector to.

setOnClickListener

Added in API level 1
void setOnClickListener (View.OnClickListener listener)

单击此视图时注册要调用的回调。 如果此视图不可点击,则可点击。

Parameters
listener View.OnClickListener: The callback that will run

setOnDismissListener

Added in API level 17
void setOnDismissListener (AutoCompleteTextView.OnDismissListener dismissListener)

设置一个侦听器,只要AutoCompleteTextView的完成列表被取消就会被调用。

Parameters
dismissListener AutoCompleteTextView.OnDismissListener: Listener to invoke when completions are dismissed

setOnItemClickListener

Added in API level 1
void setOnItemClickListener (AdapterView.OnItemClickListener l)

设置在用户单击下拉列表中的项目时将收到通知的侦听器。

Parameters
l AdapterView.OnItemClickListener: the item click listener

setOnItemSelectedListener

Added in API level 1
void setOnItemSelectedListener (AdapterView.OnItemSelectedListener l)

设置在用户选择下拉列表中的项目时将收到通知的侦听器。

Parameters
l AdapterView.OnItemSelectedListener: the item selected listener

setText

Added in API level 17
void setText (CharSequence text, 
                boolean filter)

setText(CharSequence)一样,除了它可以禁用过滤。

Parameters
text CharSequence
filter boolean: If false, no filtering will be performed as a result of this call.

setThreshold

Added in API level 1
void setThreshold (int threshold)

指定显示下拉列表之前,用户必须在编辑框中键入的最少字符数。

threshold小于或等于0时,应用1的阈值。

相关XML属性:

Parameters
threshold int: the number of characters to type before the drop down is shown

也可以看看:

setValidator

Added in API level 1
void setValidator (AutoCompleteTextView.Validator validator)

设置用于执行文本验证的验证程序。

Parameters
validator AutoCompleteTextView.Validator: The validator used to validate the text entered in this widget.

也可以看看:

showDropDown

Added in API level 1
void showDropDown ()

在屏幕上显示下拉菜单。

Protected methods

convertSelectionToString

Added in API level 1
CharSequence convertSelectionToString (Object selectedItem)

Converts the selected item from the drop down list into a sequence of character that can be used in the edit box.

Parameters
selectedItem Object: the item selected by the user for completion
Returns
CharSequence a sequence of characters representing the selected suggestion

getFilter

Added in API level 1
Filter getFilter ()

返回从获得的过滤器 getFilter() ,或 null如果 setAdapter(T)未与过滤的调用。

Returns
Filter

onAttachedToWindow

Added in API level 1
void onAttachedToWindow ()

这在视图附加到窗口时被调用。 此时它有一个Surface并将开始绘制。 请注意,此功能是保证之前被称为onDraw(android.graphics.Canvas) ,但它可以被称为第一的onDraw之前的任何时间-包括之前或之后onMeasure(int, int)

onDetachedFromWindow

Added in API level 1
void onDetachedFromWindow ()

这是在视图从窗口分离时调用的。 此时它不再有绘图表面。

onDisplayHint

Added in API level 8
void onDisplayHint (int hint)

给出这个观点暗示是否显示。 例如,当视图移出屏幕时,它可能会收到显示提示,指示视图不显示。 应用程序不应该依赖这个提示,因为不能保证他们会收到一个。

Parameters
hint int: A hint about whether or not this view is displayed: VISIBLE or INVISIBLE.

onFocusChanged

Added in API level 1
void onFocusChanged (boolean focused, 
                int direction, 
                Rect previouslyFocusedRect)

当视图的焦点状态改变时,由视图系统调用。 当焦点更改事件是由方向导航导致的,direction和previouslyFocusedRect提供了焦点来自何处的洞察。 重写时,一定要调用超类,以便进行标准的焦点处理。

Parameters
focused boolean: True if the View has focus; false otherwise.
direction int: The direction focus has moved when requestFocus() is called to give this view focus. Values are FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_FORWARD, or FOCUS_BACKWARD. It may not always apply, in which case use the default.
previouslyFocusedRect Rect: The rectangle, in this view's coordinate system, of the previously focused view. If applicable, this will be passed in as finer grained information about where the focus is coming from (in addition to direction). Will be null otherwise.

performFiltering

Added in API level 1
void performFiltering (CharSequence text, 
                int keyCode)

开始过滤下拉列表的内容。 过滤模式是编辑框的内容。 子类应该重写此方法以使用不同的模式进行过滤,例如text的子字符串。

Parameters
text CharSequence: the filtering pattern
keyCode int: the last character inserted in the edit box; beware that this will be null when text is being added through a soft input method.

replaceText

Added in API level 1
void replaceText (CharSequence text)

Performs the text completion by replacing the current text by the selected item. Subclasses should override this method to avoid replacing the whole content of the edit box.

Parameters
text CharSequence: the selected suggestion in the drop down list

setFrame

Added in API level 1
boolean setFrame (int l, 
                int t, 
                int r, 
                int b)

为此视图分配大小和位置。 这是从布局调用的。

Parameters
l int: Left position, relative to parent
t int: Top position, relative to parent
r int: Right position, relative to parent
b int: Bottom position, relative to parent
Returns
boolean true if the new size and position are different than the previous ones

Hooray!