java.lang.Object | ||
↳ | android.widget.BaseAdapter | |
↳ | android.support.v4.widget.CursorAdapter |
Known Direct Subclasses |
Known Indirect Subclasses |
Static library support version of the framework's CursorAdapter
.
Used to write apps that run on platforms prior to Android 3.0. When running
on Android 3.0 or above, this implementation is still used; it does not try
to switch to the framework's implementation. See the framework SDK
documentation for a class overview.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | FLAG_AUTO_REQUERY |
This constant is deprecated.
This option is discouraged, as it results in Cursor queries
being performed on the application's UI thread and thus can cause poor
responsiveness or even Application Not Responding errors. As an alternative,
use LoaderManager with a CursorLoader .
|
|||||||||
int | FLAG_REGISTER_CONTENT_OBSERVER | If set the adapter will register a content observer on the cursor and will call
onContentChanged() when a notification comes in. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
android.widget.Adapter
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This constructor is deprecated.
This option is discouraged, as it results in Cursor queries
being performed on the application's UI thread and thus can cause poor
responsiveness or even Application Not Responding errors. As an alternative,
use
LoaderManager with a CursorLoader . | |||||||||||
Constructor that allows control over auto-requery.
| |||||||||||
Recommended constructor.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Bind an existing view to the data pointed to by cursor
| |||||||||||
Change the underlying cursor to a new cursor.
| |||||||||||
Converts the cursor into a CharSequence. | |||||||||||
Returns the cursor.
| |||||||||||
Get a | |||||||||||
Returns a filter that can be used to constrain data with a filtering pattern. | |||||||||||
Returns the query filter provider used for filtering.
| |||||||||||
Indicates 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.
| |||||||||||
Makes a new view to hold the data pointed to by cursor.
| |||||||||||
Runs a query with the specified constraint.
| |||||||||||
Sets the query filter provider used to filter the current Cursor.
| |||||||||||
Swap in a new Cursor, returning the old Cursor.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This method is deprecated.
Don't use this, use the normal constructor. This will
be removed in the future.
| |||||||||||
Called when the
ContentObserver on the cursor receives a change notification. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
android.widget.BaseAdapter
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
android.widget.Adapter
| |||||||||||
From interface
android.widget.Filterable
| |||||||||||
From interface
android.widget.ListAdapter
| |||||||||||
From interface
android.widget.SpinnerAdapter
|
This constant is deprecated.
This option is discouraged, as it results in Cursor queries
being performed on the application's UI thread and thus can cause poor
responsiveness or even Application Not Responding errors. As an alternative,
use LoaderManager
with a CursorLoader
.
If set the adapter will call requery() on the cursor whenever a content change
notification is delivered. Implies FLAG_REGISTER_CONTENT_OBSERVER
.
If set the adapter will register a content observer on the cursor and will call
onContentChanged()
when a notification comes in. Be careful when
using this flag: you will need to unset the current Cursor from the adapter
to avoid leaks due to its registered observers. This flag is not needed
when using a CursorAdapter with a
CursorLoader
.
This constructor is deprecated.
This option is discouraged, as it results in Cursor queries
being performed on the application's UI thread and thus can cause poor
responsiveness or even Application Not Responding errors. As an alternative,
use LoaderManager
with a CursorLoader
.
Constructor that always enables auto-requery.
context | The context |
---|---|
c | The cursor from which to get the data. |
Constructor that allows control over auto-requery. It is recommended
you not use this, but instead CursorAdapter(Context, Cursor, int)
.
When using this constructor, FLAG_REGISTER_CONTENT_OBSERVER
will always be set.
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. Using true here is discouraged. |
Recommended constructor.
context | The context |
---|---|
c | The cursor from which to get the data. |
flags | Flags used to determine the behavior of the adapter; may
be any combination of FLAG_AUTO_REQUERY and
FLAG_REGISTER_CONTENT_OBSERVER .
|
Bind an existing view to the data pointed to by cursor
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. |
Change the underlying cursor to a new cursor. If there is an existing cursor it will be closed.
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.
cursor | the cursor to convert to a CharSequence |
---|
Get a View
that displays in the drop down popup
the data at the specified position in the data set.
position | index 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 |
View
corresponding to the data at the
specified position.
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.
Indicates 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.
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.
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 |
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.
constraint | the constraint with which the query must be filtered |
---|
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.
filterQueryProvider | the filter query provider or null to remove it |
---|
Swap in a new Cursor, returning the old Cursor. Unlike
changeCursor(Cursor)
, the returned old Cursor is not
closed.
newCursor | The new cursor to be used. |
---|
This method is deprecated.
Don't use this, use the normal constructor. This will
be removed in the future.
Called when the ContentObserver
on the cursor receives a change notification.
The default implementation provides the auto-requery logic, but may be overridden by
sub classes.