ResourceCursorAdapter
abstract class ResourceCursorAdapter : CursorAdapter
Known Direct Subclasses
SimpleCursorAdapter |
An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file.
|
|
An easy adapter that creates views defined in an XML file. You can specify the XML file that defines the appearance of the views.
Summary
Public methods |
open View! |
|
open View! |
Inflates view(s) from the specified XML file.
|
open Unit |
Sets the layout resource of the drop down views.
|
open Unit |
Sets the android.content.res.Resources.Theme against which drop-down views are inflated.
|
open Unit |
Sets the layout resource of the item views.
|
Inherited functions |
From class BaseAdapter
|
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!)
|
Resources.Theme? |
getDropDownViewTheme()
|
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(android.database.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. This method may take several seconds to complete, so it should only be called from a worker thread.
|
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(android.database.Cursor) , the returned old Cursor is not closed.
|
|
Public constructors
ResourceCursorAdapter
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. |
ResourceCursorAdapter
ResourceCursorAdapter(
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(android.content.Context,int,android.database.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. |
ResourceCursorAdapter
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!
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. |
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. |
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 |
setDropDownViewTheme
open fun setDropDownViewTheme(theme: Resources.Theme?): Unit
Sets the android.content.res.Resources.Theme
against which drop-down views are inflated.
By default, drop-down views are inflated against the theme of the Context
passed to the adapter's constructor.
Parameters |
theme |
Resources.Theme?: the theme against which to inflate drop-down views or null to use the theme from the adapter's context |
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 |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[]]