Adapter 官方文档的解释~~~~~~~~~~~~~~~~~好好理解~

public interface

Adapter

android.widget.Adapter

Known Indirect Subclasses ArrayAdapter<T>, BaseAdapter, CursorAdapter, HeaderViewListAdapter, ListAdapter, ResourceCursorAdapter, SimpleAdapter, SimpleCursorAdapter, SpinnerAdapter, WrapperListAdapter ArrayAdapter<T> A ListAdapter that manages a ListView backed by an array of arbitrary objects.  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.  CursorAdapter Adapter that exposes data from a Cursor to a ListView widget.  HeaderViewListAdapter ListAdapter used when a ListView has header views.  ListAdapter Extended Adapter that is the bridge between a ListView and the data that backs the list.  ResourceCursorAdapter An easy adapter that creates views defined in an XML file.  SimpleAdapter An easy adapter to map static data to views defined in an XML file.  SimpleCursorAdapter An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file.  SpinnerAdapter Extended Adapter that is the bridge between a Spinner and its data.  WrapperListAdapter List adapter that wraps another list adapter.

Class Overview

An Adapter object acts as a bridge between an AdapterView and the underlying data for that view. The Adapter provides access to the data items. The Adapter is also responsible for making a View for each item in the data set.

See Also

• ArrayAdapter
• CursorAdapter
• SimpleCursorAdapter

Summary

Constants
int	IGNORE_ITEM_VIEW_TYPE	An item view type that causes the AdapterView to ignore the item view.
int	NO_SELECTION

Public Methods
abstract int	getCount() How many items are in the data set represented by this Adapter.
abstract Object	getItem(int position) Get the data item associated with the specified position in the data set.
abstract long	getItemId(int position) Get the row id associated with the specified position in the list.
abstract int	getItemViewType(int position) Get the type of View that will be created by getView(int, View, ViewGroup) for the specified item.
abstract View	getView(int position, View convertView, ViewGroup parent) Get a View that displays the data at the specified position in the data set.
abstract int	getViewTypeCount() Returns the number of types of Views that will be created by getView(int, View, ViewGroup).
abstract boolean	hasStableIds() Indicated whether the item ids are stable across changes to the underlying data.
abstract boolean	isEmpty()
abstract void	registerDataSetObserver(DataSetObserver observer) Register an observer that is called when changes happen to the data used by this adapter.
abstract void	unregisterDataSetObserver(DataSetObserver observer) Unregister an observer that has previously been registered with this adapter via registerDataSetObserver(DataSetObserver).

Constants

public static final int IGNORE_ITEM_VIEW_TYPE

Since: API Level 1

An item view type that causes the AdapterView to ignore the item view. For example, this can be used if the client does not want a particular view to be given for conversion in getView(int, View, ViewGroup).

See Also

• getItemViewType(int)
• getViewTypeCount()

Constant Value: -1 (0xffffffff)

public static final int NO_SELECTION

Since: API Level 1

 

Constant Value: -2147483648 (0x80000000)

Public Methods

public abstract int getCount ()

Since: API Level 1

How many items are in the data set represented by this Adapter.

Returns

• Count of items.

public abstract Object getItem (int position)

Since: API Level 1

Get the data item associated with the specified position in the data set.

Parameters

position	Position of the item whose data we want within the adapter's data set.

Returns

• The data at the specified position.

public abstract long getItemId (int position)

Since: API Level 1

Get the row id associated with the specified position in the list.

Parameters

position	The position of the item within the adapter's data set whose row id we want.

Returns

• The id of the item at the specified position.

public abstract int getItemViewType (int position)

Since: API Level 1

Get the type of View that will be created by getView(int, View, ViewGroup) for the specified item.

Parameters

position	The position of the item within the adapter's data set whose view type we want.

Returns

• 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.

See Also

• IGNORE_ITEM_VIEW_TYPE

public abstract View getView (int position, View convertView, ViewGroup parent)

Since: API Level 1

Get a View that displays the data at the specified position in the data set. You can either create a View manually or inflate it from an XML layout file. When the View is inflated, the parent View (GridView, ListView...) will apply default layout parameters unless you use inflate(int, android.view.ViewGroup, boolean) to specify a root view and to prevent attachment to the root.

Parameters

position	The position of the item within the adapter's data set of the item whose view we want.
convertView	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	The parent that this view will eventually be attached to

Returns

• A View corresponding to the data at the specified position.

public abstract int getViewTypeCount ()

Since: API Level 1

 

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 when the adapter is set on the the AdapterView.

 

Returns

• The number of types of Views that will be created by this adapter

public abstract boolean hasStableIds ()

Since: API Level 1

Indicated whether the item ids are stable across changes to the underlying data.

Returns

• True if the same id always refers to the same object.

public abstract boolean isEmpty ()

Since: API Level 1

 

Returns

• true if this adapter doesn't contain any data. This is used to determine whether the empty view should be displayed. A typical implementation will return getCount() == 0 but since getCount() includes the headers and footers, specialized adapters might want a different behavior.

public abstract void registerDataSetObserver (DataSetObserver observer)

Since: API Level 1

Register an observer that is called when changes happen to the data used by this adapter.

Parameters

observer	the object that gets notified when the data set changes.

public abstract void unregisterDataSetObserver (DataSetObserver observer)

Since: API Level 1

Unregister an observer that has previously been registered with this adapter via registerDataSetObserver(DataSetObserver).

Parameters

observer	the object to unregister.

Except as noted, this content is licensed under Apache 2.0. For details and restrictions, see the Content License.

Android 2.2 r1 - 14 May 2010 15:20

Site Terms of Service - Privacy Policy - Brand Guidelines