ResourceCursorAdapter

Kotlin |Java

abstract class ResourceCursorAdapter : CursorAdapter

kotlin.Any
↳	android.widget.BaseAdapter
	↳	androidx.cursoradapter.widget.CursorAdapter
		↳	androidx.cursoradapter.widget.ResourceCursorAdapter

Known Direct Subclasses SimpleCursorAdapter SimpleCursorAdapter Static library support version of the framework's android.widget.SimpleCursorAdapter.

Static library support version of the framework's android.widget.ResourceCursorAdapter. 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.

Summary

Inherited constants

From class CursorAdapter Int FLAG_AUTO_REQUERY If set the adapter will call requery() on the cursor whenever a content change notification is delivered. Implies FLAG_REGISTER_CONTENT_OBSERVER. 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. 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 android.content.CursorLoader.

Public constructors
<init>(context: Context!, layout: Int, c: Cursor!) Constructor the enables auto-requery.
<init>(context: Context!, layout: Int, c: Cursor!, autoRequery: Boolean) Constructor with default behavior as per CursorAdapter#CursorAdapter(Context, Cursor, boolean); it is recommended you not use this, but instead ResourceCursorAdapter(Context, int, Cursor, int).
<init>(context: Context!, layout: Int, c: Cursor!, flags: Int) Standard constructor.

Public methods
open View!	newDropDownView(context: Context!, cursor: Cursor!, parent: ViewGroup!)
open View!	newView(context: Context!, cursor: Cursor!, parent: ViewGroup!) Inflates view(s) from the specified XML file.
open Unit	setDropDownViewResource(dropDownLayout: Int) Sets the layout resource of the drop down views.
open Unit	setViewResource(layout: Int) Sets the layout resource of the item views.

Inherited functions

From class CursorAdapter Unit bindView(view: View!, context: Context!, cursor: Cursor!) Bind an existing view to the data pointed to by cursor Unit changeCursor(cursor: Cursor!) Change the underlying cursor to a new cursor. If there is an existing cursor it will be closed. CharSequence! convertToString(cursor: Cursor!) 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. Int getCount() Cursor! getCursor() Returns the cursor. View! getDropDownView(position: Int, convertView: View!, parent: ViewGroup!) Filter! getFilter() FilterQueryProvider! getFilterQueryProvider() Returns the query filter provider used for filtering. When the provider is null, no filtering occurs. Any! getItem(position: Int) Long getItemId(position: Int) View! getView(position: Int, convertView: View!, parent: ViewGroup!) Boolean hasStableIds() Unit init(context: Context!, c: Cursor!, autoRequery: Boolean) Unit onContentChanged() 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. Cursor! runQueryOnBackgroundThread(constraint: CharSequence!) Runs a query with the specified constraint. This query is requested by the filter attached to this adapter. The query is provided by a android.widget.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. Unit setFilterQueryProvider(filterQueryProvider: FilterQueryProvider!) Sets the query filter provider used to filter the current Cursor. The provider's android.widget.FilterQueryProvider#runQuery(CharSequence) method is invoked when filtering is requested by a client of this adapter. Cursor! swapCursor(newCursor: Cursor!) Swap in a new Cursor, returning the old Cursor. Unlike changeCursor(Cursor), the returned old Cursor is not closed.

Public constructors

<init>

ResourceCursorAdapter(
    context: Context!, 
    layout: Int, 
    c: Cursor!)

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 android.app.LoaderManager with a android.content.CursorLoader.

Constructor the enables auto-requery.

Parameters
context	Context!: The context where the ListView associated with this adapter is running
layout	Int: resource identifier of a layout file that defines the views for this list item. Unless you override them later, this will define both the item views and the drop down views.

<init>

ResourceCursorAdapter(
    context: Context!, 
    layout: Int, 
    c: Cursor!, 
    autoRequery: Boolean)

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 android.app.LoaderManager with a android.content.CursorLoader.

Constructor with default behavior as per CursorAdapter#CursorAdapter(Context, Cursor, boolean); it is recommended you not use this, but instead ResourceCursorAdapter(Context, int, Cursor, int). When using this constructor, FLAG_REGISTER_CONTENT_OBSERVER will always be set.

Parameters
context	Context!: The context where the ListView associated with this adapter is running
layout	Int: resource identifier of a layout file that defines the views for this list item. Unless you override them later, this will define both the item views and the drop down views.
c	Cursor!: The cursor from which to get the data.
autoRequery	Boolean: 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.

<init>

ResourceCursorAdapter(
    context: Context!, 
    layout: Int, 
    c: Cursor!, 
    flags: Int)

Standard constructor.

Parameters
context	Context!: The context where the ListView associated with this adapter is running
layout	Int: Resource identifier of a layout file that defines the views for this list item. Unless you override them later, this will define both the item views and the drop down views.
c	Cursor!: The cursor from which to get the data.
flags	Int: Flags used to determine the behavior of the adapter, as per CursorAdapter#CursorAdapter(Context, Cursor, int).

Public methods

newDropDownView

open fun newDropDownView(
    context: Context!, 
    cursor: Cursor!, 
    parent: ViewGroup!
): View!

newView

open fun newView(
    context: Context!, 
    cursor: Cursor!, 
    parent: ViewGroup!
): View!

Inflates view(s) from the specified XML file.

Parameters
context	Context!: Interface to application's global information
cursor	Cursor!: The cursor from which to get the data. The cursor is already moved to the correct position.
parent	ViewGroup!: The parent to which the new view is attached to

Return
View!	the newly created view.

See Also

• android.widget.CursorAdapter#newView(android.content.Context, * android.database.Cursor, ViewGroup)

setDropDownViewResource

open fun setDropDownViewResource(dropDownLayout: Int): Unit

Sets the layout resource of the drop down views.

Parameters
dropDownLayout	Int: the layout resources used to create drop down views

setViewResource

open fun setViewResource(layout: Int): Unit

Sets the layout resource of the item views.

Parameters
layout	Int: the layout resources used to create item views