完整内容,请查看:http://www.zhdoc.net/android/reference/android/widget/SimpleCursorAdapter.html
SimpleCursorAdapter
public class SimpleCursorAdapter
extends ResourceCursorAdapter
java.lang.Object | ||||
↳ | android.widget.BaseAdapter | |||
↳ | android.widget.CursorAdapter | |||
↳ | android.widget.ResourceCursorAdapter | |||
↳ | android.widget.SimpleCursorAdapter |
An easy adapter to map columns from a cursor to TextViews or ImageViews defined in an XML file. You can specify which columns you want, which views you want to display the columns, and the XML file that defines the appearance of these views. Binding occurs in two phases. First, if a SimpleCursorAdapter.ViewBinder
is available, setViewValue(android.view.View, android.database.Cursor, int)
is invoked. If the returned value is true, binding has occured. If the returned value is false and the view to bind is a TextView, setViewText(TextView, String)
is invoked. If the returned value is false and the view to bind is an ImageView, setViewImage(ImageView, String)
is invoked. If no appropriate binding can be found, an IllegalStateException
is thrown. If this adapter is used with filtering, for instance in an AutoCompleteTextView
, you can use the SimpleCursorAdapter.CursorToStringConverter
and the FilterQueryProvider
interfaces to get control over the filtering process. You can refer to convertToString(android.database.Cursor)
and runQueryOnBackgroundThread(CharSequence)
for more information.
一个简单的适配器,从游标位置开始映射列到定义在一个XML文件中的TextView或ImageView你可以指定想要的列,想要显示列的视图,以及定义这些视图外观的XML文件。将数据绑定到视图有两个阶段。首先,如果SimpleCursorAdapter.ViewBinder
是可用的,则调用setViewValue(android.view.View, android.database.Cursor, int)
。如果返回值为true,则绑定成功。如果返回值为false,则调用setViewText(TextView, String)
,以将视图绑定到一个TextView。如果返回值为false,则调用setViewImage(ImageView, String)
,以将视图绑定到一个ImageView。如果找不到合适的绑定,则抛出一个IllegalStateException
异常。如果该适配器使用过滤,例如在AutoCompleteTextView
中,你可以使用SimpleCursorAdapter.CursorToStringConverter
和FilterQueryProvider
接口,以获得对过滤过程的控制。更多信息,你可以参考convertToString(android.database.Cursor)
和runQueryOnBackgroundThread(CharSequence)
。
摘要
嵌套类 | |
---|---|
interface | SimpleCursorAdapter.CursorToStringConverter This class can be used by external clients of SimpleCursorAdapter to define how the Cursor should be converted to a String. |
interface | SimpleCursorAdapter.ViewBinder This class can be used by external clients of SimpleCursorAdapter to bind values fom the Cursor to views. |
继承常量 |
---|
From class android.widget.CursorAdapter
|
From interface android.widget.Adapter
|
Public构造方法 | |
---|---|
SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to) This constructor was deprecated in API level 11. 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 | |
SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to, int flags) Standard constructor. |