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指南。
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() 如果字段中的文本数量达到或超过 |
ListAdapter |
getAdapter() 返回用于自动完成的可过滤列表适配器。 |
CharSequence |
getCompletionHint() 获取匹配列表底部显示的可选提示文本。 |
int |
getDropDownAnchor() 返回自动完成下拉列表所锚定到的视图的ID。 |
Drawable |
getDropDownBackground() 获取自动完成下拉列表的背景。 |
int |
getDropDownHeight() 返回自动完成下拉列表的当前高度。 |
int |
getDropDownHorizontalOffset() 获取用于自动完成下拉列表的水平偏移量。 |
int |
getDropDownVerticalOffset() 获取用于自动完成下拉列表的垂直偏移量。 |
int |
getDropDownWidth() 返回自动完成下拉列表的当前宽度。 |
AdapterView.OnItemClickListener |
getItemClickListener() 此方法在API级别3中已弃用。请使用 |
AdapterView.OnItemSelectedListener |
getItemSelectedListener() 此方法在API级别3中已弃用。请使用 |
int |
getListSelection() 获取下拉视图选择的位置,如果有的话。 |
AdapterView.OnItemClickListener |
getOnItemClickListener() 返回当用户单击下拉列表中的项目时通知的侦听器。 |
AdapterView.OnItemSelectedListener |
getOnItemSelectedListener() 返回用户在下拉列表中选择项目时通知的侦听器。 |
int |
getThreshold() 返回显示下拉列表之前用户必须键入的字符数。 |
AutoCompleteTextView.Validator |
getValidator() 如果未设置,则返回 |
boolean |
isPerformingCompletion() 标识视图当前是否正在执行文本完成,因此子类可以决定是否响应文本更改的事件。 |
boolean |
isPopupShowing() 指示是否显示弹出式菜单。 |
void |
onCommitCompletion(CompletionInfo completion) 由框架调用,以响应当前输入方法的文本完成,由它提供,调用 |
void |
onFilterComplete(int count) 通知过滤操作结束。 |
boolean |
onKeyDown(int keyCode, KeyEvent event)
|
boolean |
onKeyPreIme(int keyCode, KeyEvent event) 在关键事件由与视图层次关联的任何输入方法处理之前处理。 |
boolean |
onKeyUp(int keyCode, KeyEvent event) 的默认实现 |
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) 像 |
void |
setThreshold(int threshold) 指定显示下拉列表之前,用户必须在编辑框中键入的最少字符数。 |
void |
setValidator(AutoCompleteTextView.Validator validator) 设置用于执行文本验证的验证程序。 |
void |
showDropDown() 在屏幕上显示下拉菜单。 |
Protected methods |
|
---|---|
CharSequence |
convertSelectionToString(Object selectedItem) 将所选项目从下拉列表转换为可在编辑框中使用的字符序列。 |
Filter |
getFilter() 如果 |
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
|
定义下拉菜单中显示的提示。
必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的引用。
这对应于全局属性资源符号 completionHint
。
相关方法:
定义显示在下拉菜单中的提示视图。
必须是另一个资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
这对应于全局属性资源符号 completionHintView
。
定义在下拉菜单中显示完成建议之前用户必须键入的字符数。
必须是整数值,例如“ 100
”。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的引用。
这对应于全局属性资源符号 completionThreshold
。
相关方法:
查看将自动完成下拉列表固定到。 如果未指定,则使用文本视图本身。
必须是另一个资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
这对应于全局属性资源符号 dropDownAnchor
。
相关方法:
指定下拉的基本高度。 它的值可以是一个维数(例如“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
。
相关方法:
下拉应该水平偏移的像素数量。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可以是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的引用。
这对应于全局属性资源符号 dropDownHorizontalOffset
。
相关方法:
选择器在下拉列表中。
可能是另一种资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
可以是“ #rgb
”,“ #argb
”,“ #rrggbb
”或“ #aarrggbb
”形式的颜色值。
这对应于全局属性资源符号 dropDownSelector
。
下拉应该垂直偏移的像素数量。
必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp
”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。
这也可能是对包含此类型值的资源(形式为“ @[package:]type:name
”)或主题属性(形式为“ ?[package:][type:]name
”)的引用。
这对应于全局属性资源符号 dropDownVerticalOffset
。
相关方法:
指定下拉的基本宽度。 其值可以是用于固定宽度的维度(例如“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
。
相关方法:
用于弹出窗口的背景。
可能是另一种资源的引用,其形式为“ @[+][package:]type:name
”,或者其形式为“一个主题属性 ?[package:][type:]name
”。
可以是“ #rgb
”,“ #argb
”,“ #rrggbb
”或“ #aarrggbb
”形式的颜色值。
这对应于全局属性资源符号 popupBackground
。
相关方法:
AutoCompleteTextView (Context context)
用给定的上下文主题构造一个新的自动完成文本视图。
Parameters | |
---|---|
context |
Context : The Context the view is running in, through which it can access the current theme, resources, etc. |
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 (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 (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 (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 . |
boolean enoughToFilter ()
如果字段中的文本数量达到或超过getThreshold()
要求,则返回true
。 您可以覆盖此设置,以便在触发过滤时施加不同的标准。
Returns | |
---|---|
boolean |
ListAdapter getAdapter ()
返回用于自动完成的可过滤列表适配器。
Returns | |
---|---|
ListAdapter |
a data adapter used for auto completion |
CharSequence getCompletionHint ()
获取匹配列表底部显示的可选提示文本。
相关XML属性:
Returns | |
---|---|
CharSequence |
The hint text, if any |
int getDropDownAnchor ()
返回自动完成下拉列表所锚定到的视图的ID。
相关XML属性:
Returns | |
---|---|
int |
the view's id, or NO_ID if none specified |
Drawable getDropDownBackground ()
获取自动完成下拉列表的背景。
相关XML属性:
Returns | |
---|---|
Drawable |
the background drawable |
int getDropDownHeight ()
返回自动完成下拉列表的当前高度。 这可以是一个固定的高度,或MATCH_PARENT
来填充屏幕,或WRAP_CONTENT
以适应下拉内容的高度。
相关XML属性:
Returns | |
---|---|
int |
the height for the drop down list |
int getDropDownHorizontalOffset ()
获取用于自动完成下拉列表的水平偏移量。
相关XML属性:
Returns | |
---|---|
int |
the horizontal offset |
int getDropDownVerticalOffset ()
获取用于自动完成下拉列表的垂直偏移量。
相关XML属性:
Returns | |
---|---|
int |
the vertical offset |
int getDropDownWidth ()
返回自动完成下拉列表的当前宽度。 这可以是一个固定的宽度,或MATCH_PARENT
来填充屏幕,或WRAP_CONTENT
以适合其锚点视图的宽度。
相关XML属性:
Returns | |
---|---|
int |
the width for the drop down list |
AdapterView.OnItemClickListener getItemClickListener ()
此方法在API级别3中已被弃用。
使用getOnItemClickListener()
intead
返回当用户单击下拉列表中的项目时通知的侦听器。
Returns | |
---|---|
AdapterView.OnItemClickListener |
the item click listener |
AdapterView.OnItemSelectedListener getItemSelectedListener ()
此方法在API级别3中已被弃用。
使用getOnItemSelectedListener()
intead
返回用户在下拉列表中选择项目时通知的侦听器。
Returns | |
---|---|
AdapterView.OnItemSelectedListener |
the item selected listener |
int getListSelection ()
获取下拉视图选择的位置,如果有的话。 如果没有下拉菜单或没有选择,则返回ListView.INVALID_POSITION
。
Returns | |
---|---|
int |
the position of the current selection, if there is one, or ListView.INVALID_POSITION if not. |
也可以看看:
AdapterView.OnItemClickListener getOnItemClickListener ()
返回当用户单击下拉列表中的项目时通知的侦听器。
Returns | |
---|---|
AdapterView.OnItemClickListener |
the item click listener |
AdapterView.OnItemSelectedListener getOnItemSelectedListener ()
返回用户在下拉列表中选择项目时通知的侦听器。
Returns | |
---|---|
AdapterView.OnItemSelectedListener |
the item selected listener |
int getThreshold ()
返回显示下拉列表之前用户必须键入的字符数。
相关XML属性:
Returns | |
---|---|
int |
the minimum number of characters to type to show the drop down |
也可以看看:
AutoCompleteTextView.Validator getValidator ()
如果未设置,则返回设置为 setValidator(AutoCompleteTextView.Validator)
或 null
的验证器。
Returns | |
---|---|
AutoCompleteTextView.Validator |
boolean isPerformingCompletion ()
标识视图当前是否正在执行文本完成,因此子类可以决定是否响应文本更改的事件。
Returns | |
---|---|
boolean |
boolean isPopupShowing ()
指示是否显示弹出式菜单。
Returns | |
---|---|
boolean |
true if the popup menu is showing, false otherwise |
void onCommitCompletion (CompletionInfo completion)
由框架调用以响应当前输入方法的文本完成,由其提供,调用InputConnection.commitCompletion()
。 默认实现什么也不做; 支持自动完成的文本视图应该重写此操作以执行其所需的行为。
Parameters | |
---|---|
completion |
CompletionInfo : The auto complete text the user has selected. |
void onFilterComplete (int count)
通知过滤操作结束。
Parameters | |
---|---|
count |
int : the number of values computed by the filter |
boolean onKeyDown (int keyCode, KeyEvent event)
KeyEvent.Callback.onKeyDown()
默认实现:当 KEYCODE_DPAD_CENTER
或 KEYCODE_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. |
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. |
boolean onKeyUp (int keyCode, KeyEvent event)
的默认实现 KeyEvent.Callback.onKeyUp()
:当视图进行点击 KEYCODE_DPAD_CENTER
, KEYCODE_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. |
void onWindowFocusChanged (boolean hasWindowFocus)
当包含此视图的窗口获得或失去焦点时调用。 请注意,这与视图焦点不同:要接收关键事件,视图和其窗口都必须具有焦点。 如果一个窗口显示在需要输入焦点的窗口上,那么您自己的窗口将失去焦点,但视图焦点将保持不变。
Parameters | |
---|---|
hasWindowFocus |
boolean : True if the window containing this view now has focus, false otherwise. |
void performCompletion ()
通过将所选项从下拉列表转换为字符串来执行文本完成,用该字符串替换文本框的内容,最后解除下拉菜单。
void setAdapter (T adapter)
更改用于自动完成的数据列表。 提供的列表必须是可过滤的列表适配器。
调用者仍负责管理适配器使用的任何资源。 值得注意的是,当AutoCompleteTextView被关闭或释放时,适配器不会被通知。 常见的情况是使用CursorAdapter
,其中包含必须关闭的Cursor
。 这可以自动完成(请参阅startManagingCursor()
),或者在AutoCompleteTextView关闭时手动关闭游标。
Parameters | |
---|---|
adapter |
T : the adapter holding the auto completion data |
也可以看看:
void setCompletionHint (CharSequence hint)
设置匹配列表底部显示的可选提示文本。 这可以作为提示用户如何最好地使用列表或提供额外信息。
相关XML属性:
Parameters | |
---|---|
hint |
CharSequence : the text to be displayed to the user |
也可以看看:
void setDropDownAnchor (int id)
设置自动完成下拉列表应该锚定的视图。 直到下一次需要避免加载尚未实例化的视图时,才会加载与此id相对应的视图。
相关XML属性:
Parameters | |
---|---|
id |
int : the id to anchor the drop down list view to |
void setDropDownBackgroundDrawable (Drawable d)
设置自动完成下拉列表的背景。
相关XML属性:
Parameters | |
---|---|
d |
Drawable : the drawable to set as the background |
void setDropDownBackgroundResource (int id)
设置自动完成下拉列表的背景。
相关XML属性:
Parameters | |
---|---|
id |
int : the id of the drawable to set as the background |
void setDropDownHeight (int height)
设置自动完成下拉列表的当前高度。 这可以是一个固定的高度,或MATCH_PARENT
来填充屏幕,或WRAP_CONTENT
以适应下拉内容的高度。
相关XML属性:
Parameters | |
---|---|
height |
int : the height to use |
void setDropDownHorizontalOffset (int offset)
设置用于自动完成下拉列表的水平偏移量。
相关XML属性:
Parameters | |
---|---|
offset |
int : the horizontal offset |
void setDropDownVerticalOffset (int offset)
设置用于自动完成下拉列表的垂直偏移量。
相关XML属性:
Parameters | |
---|---|
offset |
int : the vertical offset |
void setDropDownWidth (int width)
设置自动完成下拉列表的当前宽度。 这可以是一个固定的宽度,或MATCH_PARENT
来填充屏幕,或WRAP_CONTENT
以适应其锚点视图的宽度。
相关XML属性:
Parameters | |
---|---|
width |
int : the width to use |
void setListSelection (int position)
设置下拉视图选择的位置。
Parameters | |
---|---|
position |
int : The position to move the selector to. |
void setOnClickListener (View.OnClickListener listener)
单击此视图时注册要调用的回调。 如果此视图不可点击,则可点击。
Parameters | |
---|---|
listener |
View.OnClickListener : The callback that will run |
void setOnDismissListener (AutoCompleteTextView.OnDismissListener dismissListener)
设置一个侦听器,只要AutoCompleteTextView的完成列表被取消就会被调用。
Parameters | |
---|---|
dismissListener |
AutoCompleteTextView.OnDismissListener : Listener to invoke when completions are dismissed |
void setOnItemClickListener (AdapterView.OnItemClickListener l)
设置在用户单击下拉列表中的项目时将收到通知的侦听器。
Parameters | |
---|---|
l |
AdapterView.OnItemClickListener : the item click listener |
void setOnItemSelectedListener (AdapterView.OnItemSelectedListener l)
设置在用户选择下拉列表中的项目时将收到通知的侦听器。
Parameters | |
---|---|
l |
AdapterView.OnItemSelectedListener : the item selected listener |
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. |
void setThreshold (int threshold)
指定显示下拉列表之前,用户必须在编辑框中键入的最少字符数。
当 threshold
小于或等于0时,应用1的阈值。
相关XML属性:
Parameters | |
---|---|
threshold |
int : the number of characters to type before the drop down is shown |
也可以看看:
void setValidator (AutoCompleteTextView.Validator validator)
设置用于执行文本验证的验证程序。
Parameters | |
---|---|
validator |
AutoCompleteTextView.Validator : The validator used to validate the text entered in this widget. |
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 |
Filter getFilter ()
返回从获得的过滤器 getFilter()
,或 null
如果 setAdapter(T)
未与过滤的调用。
Returns | |
---|---|
Filter |
void onAttachedToWindow ()
这在视图附加到窗口时被调用。 此时它有一个Surface并将开始绘制。 请注意,此功能是保证之前被称为onDraw(android.graphics.Canvas)
,但它可以被称为第一的onDraw之前的任何时间-包括之前或之后onMeasure(int, int)
。
void onDisplayHint (int hint)
给出这个观点暗示是否显示。 例如,当视图移出屏幕时,它可能会收到显示提示,指示视图不显示。 应用程序不应该依赖这个提示,因为不能保证他们会收到一个。
Parameters | |
---|---|
hint |
int : A hint about whether or not this view is displayed: VISIBLE or INVISIBLE . |
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. |
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. |
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 |
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 |