BaseAdapter
public
abstract
class
BaseAdapter
extends Object
implements
ListAdapter,
SpinnerAdapter
java.lang.Object | |
↳ | android.widget.BaseAdapter |
Common base class of common implementation for an Adapter
that can be
used in both ListView
(by implementing the specialized
ListAdapter
interface) and Spinner
(by implementing the
specialized SpinnerAdapter
interface).
Summary
Inherited constants |
---|
Public constructors | |
---|---|
BaseAdapter()
|
Public methods | |
---|---|
boolean
|
areAllItemsEnabled()
Indicates whether all the items in this adapter are enabled. |
CharSequence[]
|
getAutofillOptions()
Gets a string representation of the adapter data that can help
|
View
|
getDropDownView(int position, View convertView, ViewGroup parent)
Gets a |
int
|
getItemViewType(int position)
Get the type of View that will be created by |
int
|
getViewTypeCount()
Returns the number of types of Views that will be created by
|
boolean
|
hasStableIds()
Indicates whether the item ids are stable across changes to the underlying data. |
boolean
|
isEmpty()
|
boolean
|
isEnabled(int position)
Returns true if the item at the specified position is not a separator. |
void
|
notifyDataSetChanged()
Notifies the attached observers that the underlying data has been changed and any View reflecting the data set should refresh itself. |
void
|
notifyDataSetInvalidated()
Notifies the attached observers that the underlying data is no longer valid or available. |
void
|
registerDataSetObserver(DataSetObserver observer)
Register an observer that is called when changes happen to the data used by this adapter. |
void
|
setAutofillOptions(CharSequence... options)
Sets the value returned by |
void
|
unregisterDataSetObserver(DataSetObserver observer)
Unregister an observer that has previously been registered with this
adapter via |
Inherited methods | |
---|---|
Public constructors
BaseAdapter
public BaseAdapter ()
Public methods
areAllItemsEnabled
public boolean areAllItemsEnabled ()
Indicates whether all the items in this adapter are enabled. If the value returned by this method changes over time, there is no guarantee it will take effect. If true, it means all items are selectable and clickable (there is no separator.)
Returns | |
---|---|
boolean |
True if all items are enabled, false otherwise. |
getAutofillOptions
public CharSequence[] getAutofillOptions ()
Gets a string representation of the adapter data that can help
AutofillService
autofill the view backed by the adapter.
It should only be set (i.e., non-null
if the values do not represent PII
(Personally Identifiable Information - sensitive data such as email addresses,
credit card numbers, passwords, etc...). For
example, it's ok to return a list of month names, but not a list of usernames. A good rule of
thumb is that if the adapter data comes from static resources, such data is not PII - see
ViewStructure.setDataIsSensitive(boolean)
for more info.
Returns | |
---|---|
CharSequence[] |
null by default, unless implementations override it. |
getDropDownView
public View getDropDownView (int position, View convertView, ViewGroup parent)
Gets a View
that displays in the drop down popup
the data at the specified position in the data set.
Parameters | |
---|---|
position |
int : index of the item whose view we want. |
convertView |
View : the old view to reuse, if possible. Note: You should
check that this view is non-null and of an appropriate type before
using. If it is not possible to convert this view to display the
correct data, this method can create a new view. |
parent |
ViewGroup : the parent that this view will eventually be attached to |
Returns | |
---|---|
View |
a View corresponding to the data at the
specified position. |
getItemViewType
public int getItemViewType (int position)
Get the type of View that will be created by getView(int, View, ViewGroup)
for the specified item.
Parameters | |
---|---|
position |
int : The position of the item within the adapter's data set whose view type we
want. |
Returns | |
---|---|
int |
An integer representing the type of View. Two views should share the same type if one
can be converted to the other in getView(int, View, ViewGroup) . Note: Integers must be in the
range 0 to getViewTypeCount() - 1. IGNORE_ITEM_VIEW_TYPE can
also be returned. |
getViewTypeCount
public int getViewTypeCount ()
Returns the number of types of Views that will be created by
getView(int, View, ViewGroup)
. Each type represents a set of views that can be
converted in getView(int, View, ViewGroup)
. If the adapter always returns the same
type of View for all items, this method should return 1.
This method will only be called when the adapter is set on the AdapterView
.
Returns | |
---|---|
int |
The number of types of Views that will be created by this adapter |
hasStableIds
public boolean hasStableIds ()
Indicates whether the item ids are stable across changes to the underlying data.
Returns | |
---|---|
boolean |
True if the same id always refers to the same object. |
isEnabled
public boolean isEnabled (int position)
Returns true if the item at the specified position is not a separator.
(A separator is a non-selectable, non-clickable item).
The result is unspecified if position is invalid. An ArrayIndexOutOfBoundsException
should be thrown in that case for fast failure.
Parameters | |
---|---|
position |
int : Index of the item |
Returns | |
---|---|
boolean |
True if the item is not a separator |
notifyDataSetChanged
public void notifyDataSetChanged ()
Notifies the attached observers that the underlying data has been changed and any View reflecting the data set should refresh itself.
notifyDataSetInvalidated
public void notifyDataSetInvalidated ()
Notifies the attached observers that the underlying data is no longer valid or available. Once invoked this adapter is no longer valid and should not report further data set changes.
registerDataSetObserver
public void registerDataSetObserver (DataSetObserver observer)
Register an observer that is called when changes happen to the data used by this adapter.
Parameters | |
---|---|
observer |
DataSetObserver : the object that gets notified when the data set changes. |
setAutofillOptions
public void setAutofillOptions (CharSequence... options)
Sets the value returned by getAutofillOptions()
Parameters | |
---|---|
options |
CharSequence : This value may be null . |
unregisterDataSetObserver
public void unregisterDataSetObserver (DataSetObserver observer)
Unregister an observer that has previously been registered with this
adapter via registerDataSetObserver(DataSetObserver)
.
Parameters | |
---|---|
observer |
DataSetObserver : the object to unregister. |