------Java培训、Android培训、iOS培训、.Net培训、期待与您交流！ -------
package android.widget;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.view.View;
/**
* 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
* {@link android.widget.SimpleCursorAdapter.ViewBinder} is available,
* {@link ViewBinder#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,
* {@link #setViewText(TextView, String)} is invoked. If the returned value
* is false and the view to bind is an ImageView,
* {@link #setViewImage(ImageView, String)} is invoked. If no appropriate
* binding can be found, an {@link IllegalStateException} is thrown.
*
* If this adapter is used with filtering, for instance in an
* {@link android.widget.AutoCompleteTextView}, you can use the
* {@link android.widget.SimpleCursorAdapter.CursorToStringConverter} and the
* {@link android.widget.FilterQueryProvider} interfaces
* to get control over the filtering process. You can refer to
* {@link #convertToString(android.database.Cursor)} and
* {@link #runQueryOnBackgroundThread(CharSequence)} for more information.
*/
/**
* 用于将游标列映射到XML文件中定义的文本视图或图像视图的简单适配器.
* 你可以指定有哪些列，由那些视图显示这些列的内容，并通过XML定义这些视图的呈现.
* 绑定由两个阶段组成.首先，如果SimpleCursorAdapter.ViewBinder 可用，
* 则执行 setViewValue(android.view.View, android.database.Cursor, int).
* 如果返回值为真，代表发生了绑定.如果返回值为假，并且要绑定的是文本视图，
* 则执行 setViewText(TextView, String) 方法.如果返回值为假，并且要绑定的是 ImageView，
* 则执行setViewImage(ImageView, String).如果没有适当的绑定发生， 将抛出IllegalStateException.
* 如果该适配器与过滤功能同时使用，比如在 AutoCompleteTextView中，
* 可以使用 SimpleCursorAdapter.CursorToStringConverter和 FilterQueryProvider接口，用于控制过滤过程.
* 详细信息可以参考 convertToString(android.database.Cursor)和 runQueryOnBackgroundThread(CharSequence).
*/
public class SimpleCursorAdapter extends ResourceCursorAdapter {
/**
* A list of columns containing the data to bind to the UI.
* This field should be made private, so it is hidden from the SDK.
* {@hide}
*/
protected int[] mFrom;
/**
* A list of View ids representing the views to which the data must be bound.
* This field should be made private, so it is hidden from the SDK.
* {@hide}
*/
protected int[] mTo;
private int mStringConversionColumn = -1;
private CursorToStringConverter mCursorToStringConverter;
private ViewBinder mViewBinder;
String[] mOriginalFrom;
/**
* Constructor the enables auto-requery.
*
* @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 {@link android.app.LoaderManager} with a {@link android.content.CursorLoader}.
*/
/**
* 构造函数，启用自动再检索功能.
*
* 该 constructor 从 API 级别 11 开始已经废弃。
* 该选项已经废止，因为他会在应用程序的 UI 线程中执行 游标的检索，
* 会导致响应变慢甚至发生应用程序无响应错误.
* 请使用带有 CursorLoader 的 LoaderManager 来代替.
* @param context 与运行中的 SimpleListItemFactory 关联的 ListView 的上下文
* @param layout 为该列表定义了视图的布局文件标识.布局文件应该至少包括“to”中定义的视图
* @param c 数据库游标.如果游标不可用，可设为空.
* @param from 代表要绑定到UI的数据的列名列表.如果游标不可用，可设为空.
* @param to 用于显示“from”参数的列的视图.应该都是 TextViews. 视图与from参数按位置一一对应.如果游标不可用，可设为空.
*/
@Deprecated
public SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from, int[] to) {
super(context, layout, c);
mTo = to;
mOriginalFrom = from;
findColumns(c, from);
}
/**
* Standard constructor.
*
* @param context The context where the ListView associated with this
* SimpleListItemFactory is running
* @param layout resource identifier of a layout file that defines the views
* for this list item. The layout file should include at least
* those named views defined in "to"
* @param c The database cursor. Can be null if the cursor is not available yet.
* @param from A list of column names representing the data to bind to the UI. Can be null
* if the cursor is not available yet.
* @param to The views that should display column in the "from" parameter.
* These should all be TextViews. The first N views in this list
* are given the values of the first N columns in the from
* parameter. Can be null if the cursor is not available yet.
* @param flags Flags used to determine the behavior of the adapter,
* as per {@link CursorAdapter#CursorAdapter(Context, Cursor, int)}.
*/
/**
* 标准构造函数
*
* @param context 与运行中的 SimpleListItemFactory 关联的 ListView 的上下文
* @param layout 为该列表定义了视图的布局文件标识.布局文件应该至少包括“to”中定义的视图
* @param c 数据库游标.如果游标不可用，可设为空.
* @param from 代表要绑定到UI的数据的列名列表.如果游标不可用，可设为空.
* @param to 用于显示“from”参数的列的视图.应该都是 TextViews. 视图与from参数按位置一一对应.如果游标不可用，可设为空.
* @param flags 用于决定适配器行为的标志位.与 CursorAdapter(Context, Cursor, int) 相同.
*/
public SimpleCursorAdapter(Context context, int layout, Cursor c, String[] from,
int[] to, int flags) {
super(context, layout, c, flags);
mTo = to;
mOriginalFrom = from;
findColumns(c, from);
}
......
}
