android.widget
public
abstract
class
android.widget.CursorAdapter
Adapter that exposes data from a Cursor to a
ListView widget. The Cursor must include
a column named "_id" or this class will not work.
Known Direct Subclasses
Known Indirect Subclasses
SimpleCursorAdapter |
An easy adapter to map columns from a cursor to TextViews or ImageViews
defined in an XML file. |
Summary
Fields
Public Constructors
Public Methods
abstract |
|
|
|
|
void |
bindView(View view, Context context, Cursor cursor) |
|
|
|
|
|
void |
changeCursor(Cursor cursor) |
|
|
|
|
|
CharSequence |
convertToString(Cursor cursor) |
|
|
final |
|
|
int |
getCount() |
|
|
|
|
|
Cursor |
getCursor() |
|
|
|
|
|
View |
getDropDownView(int position, View convertView, ViewGroup parent) |
|
|
|
|
|
Filter |
getFilter() |
|
|
|
|
|
FilterQueryProvider |
getFilterQueryProvider() |
|
|
final |
|
|
Object |
getItem(int position) |
|
|
final |
|
|
long |
getItemId(int position) |
|
|
|
|
|
View |
getView(int position, View convertView, ViewGroup parent) |
|
|
|
|
|
boolean |
hasStableIds() |
|
|
|
|
|
View |
newDropDownView(Context context, Cursor cursor, ViewGroup parent) |
abstract |
|
|
|
|
View |
newView(Context context, Cursor cursor, ViewGroup parent) |
|
|
|
|
|
Cursor |
runQueryOnBackgroundThread(CharSequence constraint) |
|
|
|
|
|
void |
setFilterQueryProvider(FilterQueryProvider filterQueryProvider) |
Protected Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Fields
protected
boolean
mAutoRequery
protected
CursorAdapter.ChangeObserver
mChangeObserver
protected
CursorFilter
mCursorFilter
protected
boolean
mDataValid
protected
int
mRowIDColumn
Public Constructors
public
CursorAdapter(Context context, Cursor c)
Constructor. The adapter will call requery() on the cursor whenever
it changes so that the most recent data is always displayed.
Parameters
context
| The context
|
c
| The cursor from which to get the data. |
public
CursorAdapter(Context context, Cursor c, boolean autoRequery)
Constructor
Parameters
context
| The context |
c
| The cursor from which to get the data. |
autoRequery
| If true the adapter will call requery() on the
cursor whenever it changes so the most recent
data is always displayed.
|
Public Methods
public
abstract
void
bindView(View view, Context context, Cursor cursor)
Bind an existing view to the data pointed to by cursor
Parameters
view
| Existing view, returned earlier by newView |
context
| Interface to application's global information |
cursor
| The cursor from which to get the data. The cursor is already
moved to the correct position.
|
public
void
changeCursor(Cursor cursor)
Change the underlying cursor to a new cursor. If there is an existing cursor it will be
closed.
Parameters
cursor
| the new cursor to be used
|
Converts the cursor into a CharSequence. Subclasses should override this
method to convert their results. The default implementation returns an
empty String for null values or the default String representation of
the value.
Parameters
cursor
| the cursor to convert to a CharSequence |
Returns
- a CharSequence representing the value
public
final
int
getCount()
public
View
getDropDownView(int position, View convertView, ViewGroup parent)
Get a View that displays in the drop down popup
the data at the specified position in the data set.
public
Filter
getFilter()
Returns a filter that can be used to constrain data with a filtering
pattern.
This method is usually implemented by Adapter
classes.
Returns the query filter provider used for filtering. When the
provider is null, no filtering occurs.
Returns
- the current filter query provider or null if it does not exist
public
final
Object
getItem(int position)
public
final
long
getItemId(int position)
public
boolean
hasStableIds()
Indicated whether the item ids are stable across changes to the
underlying data.
Makes a new drop down view to hold the data pointed to by cursor.
Parameters
context
| Interface to application's global information |
cursor
| The cursor from which to get the data. The cursor is already
moved to the correct position. |
parent
| The parent to which the new view is attached to |
Makes a new view to hold the data pointed to by cursor.
Parameters
context
| Interface to application's global information |
cursor
| The cursor from which to get the data. The cursor is already
moved to the correct position. |
parent
| The parent to which the new view is attached to |
public
Cursor
runQueryOnBackgroundThread(CharSequence constraint)
Runs a query with the specified constraint. This query is requested
by the filter attached to this adapter.
The query is provided by a
FilterQueryProvider.
If no provider is specified, the current cursor is not filtered and returned.
After this method returns the resulting cursor is passed to
changeCursor(Cursor)
and the previous cursor is closed.
This method is always executed on a background thread, not on the
application's main thread (or UI thread.)
Contract: when constraint is null or empty, the original results,
prior to any filtering, must be returned.
Parameters
constraint
| the constraint with which the query must be filtered |
Returns
- a Cursor representing the results of the new query
public
void
setFilterQueryProvider(FilterQueryProvider filterQueryProvider)
Sets the query filter provider used to filter the current Cursor.
The provider's
runQuery(CharSequence)
method is invoked when filtering is requested by a client of
this adapter.
Parameters
filterQueryProvider
| the filter query provider or null to remove it |
Protected Methods
protected
void
init(Context context, Cursor c, boolean autoRequery)