MaterialAutoCompleteTextView

View Source

public class MaterialAutoCompleteTextView

A special sub-class of android.widget.AutoCompleteTextView that is auto-inflated so that auto-complete text fields (e.g., for an Exposed Dropdown Menu) are accessible when being interacted through a screen reader.

The ListPopupWindow of the android.widget.AutoCompleteTextView is not modal, so it does not grab accessibility focus. The MaterialAutoCompleteTextView changes that by having a modal ListPopupWindow that is displayed instead of the non-modal one, so that the first item of the popup is automatically focused. This simulates the behavior of the .

Summary

Public fields
`final float`	`popupElevation`
`int`	`simpleItemSelectedColor`
`ColorStateList`	`simpleItemSelectedRippleColor`

Public constructors
`MaterialAutoCompleteTextView(Context context)`
`MaterialAutoCompleteTextView( Context context, AttributeSet attributeSet )`
`MaterialAutoCompleteTextView( Context context, AttributeSet attributeSet, int defStyleAttr )`

Public methods
`void`	`dismissDropDown()`
`ColorStateList`	`getDropDownBackgroundTintList()` Returns the color of the popup dropdown container.
`CharSequence`	`getHint()`
`float`	`getPopupElevation()` Returns the elevation of the dropdown popup.
`int`	`getSimpleItemSelectedColor()` Returns the color of the default selected popup dropdown item.
`ColorStateList`	`getSimpleItemSelectedRippleColor()` Returns the ripple color of the default selected popup dropdown item, or null if not set.
`void`	`onWindowFocusChanged(boolean hasWindowFocus)`
`void`	`<T extends ListAdapter & Filterable> setAdapter(T adapter)`
`void`	`setDropDownBackgroundDrawable(Drawable d)`
`void`	`setDropDownBackgroundTint(int dropDownBackgroundColor)` Sets the color of the popup dropdown container.
`void`	`setDropDownBackgroundTintList(ColorStateList dropDownBackgroundTint)` Sets the color of the popup dropdown container.
`void`	`setOnItemSelectedListener(OnItemSelectedListener listener)`
`void`	`setRawInputType(int type)`
`void`	`setSimpleItemSelectedColor(int simpleItemSelectedColor)` Sets the color of the default selected popup dropdown item to be used along with `R.attr.simpleItemLayout`.
`void`	`setSimpleItemSelectedRippleColor( ColorStateList simpleItemSelectedRippleColor )` Sets the ripple color of the selected popup dropdown item to be used along with `R.attr.simpleItemLayout`.
`void`	`setSimpleItems(String[] stringArray)` Sets the simple string items of auto-completion with the given string array.
`void`	`setSimpleItems(int stringArrayResId)` Sets the simple string items of auto-completion with the given string array resource.
`void`	`showDropDown()`

Protected methods
`void`	`onAttachedToWindow()`
`void`	`onDetachedFromWindow()`
`void`	`onMeasure(int widthMeasureSpec, int heightMeasureSpec)`

Public fields

popupElevation

public final float popupElevation

simpleItemSelectedColor

public int simpleItemSelectedColor

simpleItemSelectedRippleColor

public ColorStateList simpleItemSelectedRippleColor

Public constructors

MaterialAutoCompleteTextView

public MaterialAutoCompleteTextView(Context context)

MaterialAutoCompleteTextView

public MaterialAutoCompleteTextView(
    Context context,
    AttributeSet attributeSet
)

MaterialAutoCompleteTextView

public MaterialAutoCompleteTextView(
    Context context,
    AttributeSet attributeSet,
    int defStyleAttr
)

Public methods

dismissDropDown

public void dismissDropDown()

getDropDownBackgroundTintList

public ColorStateList getDropDownBackgroundTintList()

Returns the color of the popup dropdown container.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_dropDownBackgroundTint

See also
`setDropDownBackgroundTint`
`setDropDownBackgroundTintList`

getHint

public CharSequence getHint()

getPopupElevation

public float getPopupElevation()

Returns the elevation of the dropdown popup.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_android_popupElevation

getSimpleItemSelectedColor

public int getSimpleItemSelectedColor()

Returns the color of the default selected popup dropdown item.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_simpleItemSelectedColor

See also
`setSimpleItemSelectedColor`

getSimpleItemSelectedRippleColor

public ColorStateList getSimpleItemSelectedRippleColor()

Returns the ripple color of the default selected popup dropdown item, or null if not set.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_simpleItemSelectedRippleColor

See also
`setSimpleItemSelectedRippleColor`

onWindowFocusChanged

public void onWindowFocusChanged(boolean hasWindowFocus)

setAdapter

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

setDropDownBackgroundDrawable

public void setDropDownBackgroundDrawable(Drawable d)

setDropDownBackgroundTint

public void setDropDownBackgroundTint(int dropDownBackgroundColor)

Sets the color of the popup dropdown container. It will take effect only if the popup background is a MaterialShapeDrawable, which is the default when using a Material theme.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_dropDownBackgroundTint

Parameters
`int dropDownBackgroundColor`	the popup dropdown container color

See also
`setDropDownBackgroundTintList`
`getDropDownBackgroundTintList`

setDropDownBackgroundTintList

public void setDropDownBackgroundTintList(ColorStateList dropDownBackgroundTint)

Sets the color of the popup dropdown container. It will take effect only if the popup background is a MaterialShapeDrawable, which is the default when using a Material theme.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_dropDownBackgroundTint

Parameters
`ColorStateList dropDownBackgroundTint`	the popup dropdown container tint as a ColorStateList object.

See also
`setDropDownBackgroundTint`
`getDropDownBackgroundTintList`

setOnItemSelectedListener

public void setOnItemSelectedListener(OnItemSelectedListener listener)

setRawInputType

public void setRawInputType(int type)

setSimpleItemSelectedColor

public void setSimpleItemSelectedColor(int simpleItemSelectedColor)

Sets the color of the default selected popup dropdown item to be used along with R.attr.simpleItemLayout.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_simpleItemSelectedColor

Parameters
`int simpleItemSelectedColor`	the selected item color

See also
`getSimpleItemSelectedColor`
`setSimpleItems`

setSimpleItemSelectedRippleColor

public void setSimpleItemSelectedRippleColor(
    ColorStateList simpleItemSelectedRippleColor
)

Sets the ripple color of the selected popup dropdown item to be used along with R.attr.simpleItemLayout.

ref com.google.android.material.R.styleable#MaterialAutoCompleteTextView_simpleItemSelectedRippleColor

Parameters
`ColorStateList simpleItemSelectedRippleColor`	the ripple color state list

See also
`getSimpleItemSelectedRippleColor`
`setSimpleItems`

setSimpleItems

public void setSimpleItems(String[] stringArray)

Sets the simple string items of auto-completion with the given string array. This method will create a default ArrayAdapter with a default item layout specified by R.attr.simpleItemLayout to display auto-complete items.

See also
`setSimpleItems`
`setAdapter(ListAdapter)`

setSimpleItems

public void setSimpleItems(int stringArrayResId)

Sets the simple string items of auto-completion with the given string array resource. This method will create a default ArrayAdapter with a default item layout specified by R.attr.simpleItemLayout to display auto-complete items.

See also
`setSimpleItems`
`setAdapter(ListAdapter)`

showDropDown

public void showDropDown()

Protected methods

onAttachedToWindow

protected void onAttachedToWindow()

onDetachedFromWindow

protected void onDetachedFromWindow()

onMeasure

protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec)