Android官方文档阅读记录

用法：1、列举已阅读的section, artice, class, lesson等标题。2、检索

Common Layouts

LinearLayout会自动创建scroll bar。

Building Layouts with an Adapter

ArrayAdapter 用法

//1、准备数据，创建 AdpaterString[] myStringArray = getMyStringArray();ArrayAdapter adapter = new ArrayAdapter<String>(this,         android.R.layout.simple_list_item_1, myStringArray);//2、（可选）/*ArrayAdapterm默认创建TextView，显示字符串。要显示别的东西，例如image, bool，需子类化ArrayAdapter，重定义 ArrayAdapter.getView()*///3、绑定adpater和AdapterViewListView listView = (ListView) findViewById(R.id.listview);listView.setAdapter(adapter);

SimpleCursorAdapter 用法

//1、得到Cursor（也可先不获取cursor，用null，等到数据异步加载完成后再，再用changeCursor()设置cursor）Cursor cursor = db.query(...);String[] columns = {"name", "phone"};String[] fromColumns = {ContactsContract.Data.DISPLAY_NAME,                         ContactsContract.CommonDataKinds.Phone.NUMBER};int[] toViews = {R.id.display_name,                 R.id.phone_number};//2、创建AdapterSimpleCursorAdapter adapter = new SimpleCursorAdapter(this,         R.layout.person_name_and_number, cursor, fromColumns, toViews, 0);//3、ViewBinder（可选）若有SimpleCursorAdapter不支持的View，可创建//    SimpleCursorAdapter.ViewBinder，负责将Cursor中的column，绑定到该view。//    binder也可以改变SimpleCursorAdapter默认绑定方式。SimpleCursorAdapter.ViewBinder binder = new SimpleCursorAdapter.ViewBinder() {    public boolean setViewValue(View view, Cursor cursor, int columnIndex) {        /*返回false，表示这里没有处理，还是用默认的方式。返回true，表示使用这里的方式*/        String columnName = cursor.getColumnName(columnIndex);        if(columnName.equals("something")) {            SomeView sv = (SomeView)view;            //get data from cursor, and deliver to view            return true;        }    return false;}};adapter.setViewBinder(binder);//4、setAdapter: 绑定到ListViewListView listView = getListView();listView.setAdapter(adapter);//数据改变后，调用ArrayAdapter.notifyDataSetChanged()，刷新数据显示。// Create a message handling object as an anonymous class.private OnItemClickListener mMessageClickedHandler = new OnItemClickListener() {    public void onItemClick(AdapterView parent, View v, int position, long id) {        // Do something in response to the click }    };listView.setOnItemClickListener(mMessageClickedHandler);//5、（此处代码在其他位置）ListView lv = getListView();lv.changeCursor(cursor);    //旧的cursor会被关闭 

Accessing Resources

Loaders

基本功能：异步加载数据、数据更新后自动重新查询、configuration change之后，自动重新连接cursor。

Dialogs

Dialog是基类一般不用，选用： 1、AlertDialog   2、DialogFragment

DialogFragment更好。不要用Progress Dialog (用 ProgressBar)

要使用fragment来管理dialog，需要确保activity是继承自 FragmentActivity(Android 3.0以下版本，高于3.0的还是用标准Activity类)

Creating a Dialog Fragment

用法：1、继承DialogFragment 2、定义 onCreateDialog() [根据需要定义其他callback]  3、新建dialog fragment, 调用 show()

public class FireMissilesDialogFragment extends DialogFragment {    @Override    public Dialog onCreateDialog(Bundle savedInstanceState) {        // Use the Builder class for convenient dialog construction        AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());        builder.setMessage(R.string.dialog_fire_missiles)               .setPositiveButton(R.string.fire, new DialogInterface.OnClickListener() {                   public void onClick(DialogInterface dialog, int id) {                       // FIRE ZE MISSILES!                   }               })               .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {                   public void onClick(DialogInterface dialog, int id) {                       // User cancelled the dialog                   }               });        // Create the AlertDialog object and return it        return builder.create();    }}

Building an Alert Dialog

AlertDialog分为三个区域：1、title(content area很小时常常不用） 2、content area 3、button bar(3 buttons at most)

用AlertDialog.Builder来创建dialog：1、new AlertDialog.Builder()   2、builder.setXXX()   3、AlertDialog dialog = builder.create()

// 1. Instantiate an AlertDialog.Builder with its constructorAlertDialog.Builder builder = new AlertDialog.Builder(getActivity());// 2. Chain together various setter methods to set the dialog characteristicsbuilder.setMessage(R.string.dialog_message)       .setTitle(R.string.dialog_title);// 3. Get the AlertDialog from create()AlertDialog dialog = builder.create();

Building an Alert Dialog -> Adding Buttons    按钮类型：Positive、Negative、Neutral

AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());builder.setPositiveButton(R.string.ok, new DialogInterface.OnClickListener() {           public void onClick(DialogInterface dialog, int id) {               // User clicked OK button           }       });builder.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {           public void onClick(DialogInterface dialog, int id) {               // User cancelled the dialog           }       });// Set other dialog properties...AlertDialog dialog = builder.create();

Builing an Alert Dialog -> Adding a list    类型：单选list、持久单选list（radiobutton）、持久多选list（checkbox）——持久的意思：点击一个item，对话框不会关闭

setItems(), setSingleChoiceItems(), setMultiChoiceItems()

    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());    builder.setTitle(R.string.pick_color);           .setItems(R.array.colors_array, new DialogInterface.OnClickListener() {               public void onClick(DialogInterface dialog, int which) {               // The 'which' argument contains the index position               // of the selected item           }    });

注：设置list除了setItems() 也可用 setAdapter()

@Overridepublic Dialog onCreateDialog(Bundle savedInstanceState) {    mSelectedItems = new ArrayList();  // Where we track the selected items    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());    builder.setTitle(R.string.pick_toppings)    // Specify the list array, the items to be selected by default (null for none),    // and the listener through which to receive callbacks when items are selected           .setMultiChoiceItems(R.array.toppings, null,                      new DialogInterface.OnMultiChoiceClickListener() {               @Override               public void onClick(DialogInterface dialog, int which,                       boolean isChecked) {                   if (isChecked) {                       mSelectedItems.add(which);                   } else if (mSelectedItems.contains(which)) {                       mSelectedItems.remove(Integer.valueOf(which));                   }               }           })           .setPositiveButton(R.string.ok, new DialogInterface.OnClickListener() {               @Override               public void onClick(DialogInterface dialog, int id) {                   // User clicked OK, so save the mSelectedItems results somewhere                   // or return them to the component that opened the dialog                   ...               }           })           .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {               @Override               public void onClick(DialogInterface dialog, int id) {                   ...               }           });    return builder.create();}

Creating a Custom Layout

步骤：按照以上AlertDialog.Builder用法， 将setItems() 改为setView() 设置custom layout。

该layout只占用content area，不占用title, button bar。

一般需要用LayoutInflater，加载layout

public Dialog onCreateDialog(Bundle savedInstanceState) {    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());    LayoutInflater inflater = getActivity().getLayoutInflater();    // Inflate and set the layout for the dialog    // Pass null as the parent view because it is going in the dialog layout    builder.setView(inflater.inflate(R.layout.dialog_signin, null))           .setPositiveButton(R.string.signin, new DialogInterface.OnClickListener() {               @Override               public void onClick(DialogInterface dialog, int id) {                   // sign in the user ...               }           })           .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {               public void onClick(DialogInterface dialog, int id) {                   LoginDialogFragment.this.getDialog().cancel();               }           });          return builder.create();}

Passing Events Back to the Dialog's Host

方法：1、在DialogFragment中，设计一个interface，定义callback  2、host 实现这个接口及callback

3、创建DialogFragment时，想办法让dialog得到host引用（例如，通过Fragment.onAttach()  或 getActivity()）。

4、点击事件的代码通过接口访问host component，把对象传过去

注：其实就是让dialog引用创建它的host(跟以前的做法一样)，因为使用了interface，比较灵活。

注：没有特别的API，属编码设计技巧，看原文。

Showing a Dialog

方法：1. new DialogFragment   -> 2.show()

提示：可以通过 FragmentActivity.getSupportedFragmentManager()  or Fragment.getFragmentManager() 获得 FragmentManager

调用show()之后，这个fragment 其实被 FragmentManager管理起来了（会被自动删除）。不考虑复用以前的fragment。

public void confirmFireMissiles() {    DialogFragment newFragment = new FireMissilesDialogFragment();    newFragment.show(getSupportFragmentManager(), "missiles");}

Showing a Dialog Fullscreen or as an embeded Fragment

让一部分UI既作为dialog，又作为 fullscreen / embeded fragment

//TODO

原文链接

Showing an activity as a dialog on large screens

(正好与上面相反)  把activity作为dialog，只需把activity的theme设为 Theme.Holo.DialogWhenLarge 或者Theme.Holo.Dialog，不用写代码。

Theme.Holo.DialogWhenLarge  只有在屏幕大的设备上运行时，activity作为dialog显示。

Theme.Holo.Dialog  一律将activity作为dialog。

<activity android:theme="@android:style/Theme.Holo.DialogWhenLarge" >

Dismissing a Dialog

涉及DialogFragment的几个函数： dismiss()   onDismiss()   cancel()   onCancel()

Pickers

picker就是下面选时间和日期的widget

Creating a Time Picker

跟Dialogs文档中创建对话框的方法完全一样，要求：

1、在onCreateDialog()中返回 DatePickDialog / TimePickerDialog。

2、host实现一个TimePickerDialog.OnTimeSetListener 接口，响应dialog完成时的callback。

原文链接（注：演示代码是fragment自己实现那个接口的，这个意义不大，要像Dialogs中的那样，让host实现这个接口。fragment通过onAttach()获得host）

Creating a Date Picker

同上

（1、概述、解释、介绍、原理、工作机制等内容一概省略。2、用法、注意事项。3、来源：Android Developers）

备注：csdn编辑器不使用复制粘贴，格式很容易混乱，经常自动插入一些tag。

为什么英文难理解，个人分析得出的原因：

1、过度追求准确，强调语法：第一、三人称。。。。 单数复数。。。时态。。。。

2、主次不清，重要信息常位于句子后半部。。。常把重要信息作为定语从句，前半句显得毫无意义没多少信息。

3、常常动词名词不分，动词常常直接作为名词，表示抽象的概念。

4、习语、短语多，从字面上无法直接理解涵义，这些短语的真正含义与单词本身含义相差甚远。