《Android Dev Guide》系列教程12：用户界面之建立对话框Dialogs
懒骨头（http://blog.csdn.com/iamlazybone）
建立对话框Dialog
Dialog是一个常见的显示在当前activity之上的小窗口。下面的activity会失去焦点，而dialog回接受用户输入。dialog常用在与程序直接相关联的通知和短小的activity中。
Android API支持以下几种dialog：
AlertDialog：
它可以包含0、1、2、3个按钮，或者一个列表或者多选单选按钮等，它是一个功能最强大的dialog接口，详细信息可参考下面的章节。
ProgressDialog:
它会显示一个进度条或者进度环，因为他是AlertDialog的子类，所有野支持按钮。
DatePickerDialog：
用来选择日期的对话框。
TimerPickerDialog：
用来选择时间的。
如果你想要定制自己的dialog，你可以继承Dialog对象，或者它的任何一个子类，并且定义一个新的布局。
--------------------------------------------------------------------------------
显示一个Dialog
Dialog 总是被当做activity的一部分来创建和显示。你可以在activity的onCreateDialog（int）方法中创建一个dialog。当你使用这个方法，android系统会自动的管理每个dialog的状态并且关联到所在的activity中，让这个activity成为dialog的管理者。每个dialog都会继承activity的某些特性。例如，当dialog打开时，按下menu弹出的是所在activity的菜单，调节的是所在activity的音量。
注意：如果你决定在onCreateDialog（）方法之外建立dialog，他将不会连接到activity中，此时，你可以使用setOwnerActivity（Activity）方法来绑定activity。
当你显示dialog时，调用showDialog（int）来传递一个dialog的id句柄。
当一个dialog首次显示时，android会在实例化dialog的activity中调用onCreateDialog（int）方法。回调方法会传递相同的id给showDialog(int)。当创建完一个dialog后，会再方法的最后返回这个对象。
在dialog显示前，android回调用可选的方法：onPrepareDialog（int，Dialog）。如果你想在每次调用dialog时改变一些配置的话，你可以定义这个方法。OnPrepareDialog（int，Dialog）方法会在每次调用dialog时调用，而onCreateDialog（int）方法只会调用一次。如果你不定义onPrepareDialog（）方法，那么打开的dialog会保持上一次的状态。这个方法也会传递dialog的id句柄。
定义这两个onXXX（）方法最好使用一个switch结构来检测Id参数，每一个case项都应该创建自己的dialog。例如。想象一个游戏使用两个不同的dialog，一个暂停一个结束游戏：
view plaincopy to clipboardprint?
static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;
static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;
然后，再onCreateDialog（int）里根据id创建dialog：
view plaincopy to clipboardprint?
protected Dialog onCreateDialog(int id) {
}
protected Dialog onCreateDialog(int id) {
}
注意：在例子中没有详写，因为定义dialog属于另外的章节。
现在可以调用showDilaog（int）来显示一个dialog了：
view plaincopy to clipboardprint?
showDialog(DIALOG_PAUSED_ID);
showDialog(DIALOG_PAUSED_ID);
--------------------------------------------------------------------------------
取消Dialog的显示
调用dialog的dismiss（）方法可以隐藏正在显示的dialog，如果必要的话，可以调用activity的dismissDialog(int)方法，他俩效果是一样的。如果使用的onCreateDialog（int）方法来管理dialog的状态，那么每次当你的dialog消失时，对话框的状态都会被activity保存着。如果不太需要这个对话框或者不希望activity保留dialog的状态，可以调用removeDialog(int)方法。它会删除任何关于dialog的引用，如果dialog正在显示，此方法会让dialog隐藏。
隐藏dialog监听器的使用
如果你想让activity在dialog隐藏时执行某些动作，那么你可以建立一个监听器。
首先定义DialogInterface.OnDismissListerner 接口，这个接口只有一个方法，onDismiss（DialogInterface），当dialog隐藏时被调用，然后传递OnDismissListener 对象给setOnDismissLister（）方法。
然而，注意dialog也可以是取消，用户让这个dialog取消也是一种特殊的情况。当用户按下back键时，或者调用cancel（）方法时会发生这种情况。当一个dialog被取消时，OnDismissLister监听器仍然会收到通知，但如果你喜欢的到明确的取消消息，可以注册DialogInterface.OnCancelLister监听器。
--------------------------------------------------------------------------------
AlertDialog的创建
AlertDialog时Dialog的子类，Dilaog绝大多数是这个强大类型，你可以在以下情况下使用：
@ 一个标题
@ 一个文本信息
@ 一个两个或者三个按钮
@ 一个单选或者多选列表
建立AlertDialog，使用AlertDialog.Builder子类。使用AlertDialog.Builder(Context)方法来获得一个Builder，并且使用它的公共方法来定义AlertDialog所有的属性。最后，调用create（）方法来显示。
下面显示了如何定义AlertDialog.Builder类的一些属性，如果在onCreateDialog（）方法中使用了例子中的代码，你可以返回结果对话框来显示这个dialog。
添加按钮
创建一个上图所示包含按钮的AlertDialog，可以使用setXXXButton（）方法：
view plaincopy to clipboardprint?
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setMessage("Are you sure you want to exit?")
AlertDialog alert = builder.create();
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setMessage("Are you sure you want to exit?")
AlertDialog alert = builder.create();
首先，通过setMessage（CharSequence）为dialog添加一个message，然后通过setCancelable(boolean)方法让此dialog无法通过按back键来取消。每个按钮都需要调用setXXXButton（）方法，例如setPositiveButton（）方法，DialogInterface.OnClickListener（）类会定义按下按钮所要做的处理。
注意：每种类型的按钮只能加一个，这就是说，你不能添加多于一个的positive按钮。最多能添加三个按钮，positive, neutral, 和 negative.他们名字所显示的功能并未实现，但能帮你记住要实现的功能。
添加一个列表
如上图所示，使用setItems（）方法添加可选列表：
view plaincopy to clipboardprint?
final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setItems(items, new DialogInterface.OnClickListener() {
});
AlertDialog alert = builder.create();
final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setItems(items, new DialogInterface.OnClickListener() {
});
AlertDialog alert = builder.create();
首先，使用setTitle（CharSequence）方法设置标题，然后使用setItem（）方法添加可选列表，这个列表会接收一个item数组来显示，DialogInterFace.OnClickListener类会定义他们的点击事件。
添加选择框和单选按钮
通过setMultiChoiceItems（）方法或 setSingleChoiceItems（）方法来分别建立一个多选按钮列表或者单选列表，如果再onCreateDialog（）方法中建立了其中一种列表，android会为你管理这个list。当activity处于活动状态时，dialog会记住当才选中项，如果退出了程序，选择结果便会丢失。
注意：当用户离开或者暂停activity时，如果你想保存选择状态，你必须在整个activity的生命周期中保存这个设置。永久的保存所选项，甚至当前进程完全被关闭，你需要使用数据存储方式来保存。建立一个如上图所示的列表dialog，代码和上面的例子相同，只需要把setItems（）方法改为setSingleChoiceItems（）方法即可。
view plaincopy to clipboardprint?
final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setSingleChoiceItems(items, -1, new DialogInterface.OnClickListener() {
});
AlertDialog alert = builder.create();
final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setSingleChoiceItems(items, -1, new DialogInterface.OnClickListener() {
});
AlertDialog alert = builder.create();
setSingleChoiseItems()方法的第二个参数是checkedItem的id值，从0开始对应着位置，如果返回”-1“表明没有选中任何项。
--------------------------------------------------------------------------------
进度对话框 ProgressDialog 的建立
ProgressDialog时AlertDialog的子类，它会显示一个表示进度的圆形动画，来表示一个进度或者任务正在运行，也可以时一个进度条，能清晰的表示出进度。他也能添加按钮，比如取消一个下载进程。
调用ProgressDialog.show()方法可以显示进程对话框，例如，上图的对话框可通过如下代码生成：
view plaincopy to clipboardprint?
ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "",
ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "",
第一个参数是程序的Context引用，四二个为标题，第三个为显示的信息，最后一个为类型，（当创建进度条时才会用到，下节讨论）。
默认的进度条为圆形的样式，如果你想生成一个通过具体数值来显示任务的加载情况的进度条，下一节会讨论。
进度条的显示
显示一个进度条要经过以下几个步骤：
1-使用ProgressDialog（Context）方法初始化
2-使用setProgressStyle（int）方法设置类型。
3-调用show（）方法显示，或者在onCreateDialog（int）方法里返回一个ProgressDialog。
4-你可以调用setProgress（int）方法，根据整体的任务完成度来设置一个具体进度值，或者使用incrementPressBy（int）来设置一个增长值。
例如：
view plaincopy to clipboardprint?
ProgressDialog progressDialog;
progressDialog = new ProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);
ProgressDialog progressDialog;
progressDialog = new ProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);
设置代码非常简单，大部分代码是在dialog参与进程并且更新的功能里。你会发现，另起一个线程来做这个工作是很有必要的，要把消息传递给activity的UI线程里需要用到 Handler 消息机制。如果你并不熟悉使用额外的线程，那么看这个例子：
这个例子使用了第二个线程来跟踪任务的进度（实际上只是在数值上加到100），线程通过 Handler 发了一个Message 给主activity，然后主activity更新ProgressDialog。
view plaincopy to clipboardprint?
package com.example.progressdialog;
import android.app.Activity;
import android.app.Dialog;
import android.app.ProgressDialog;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
public class NotificationTest extends Activity {