创建Dialog

Android学习笔记--创建Dialog

1.分类
(1)AlertDialog.它能够管理0个`1个`2个`3个按钮和一个包含radio或者checkbox的可选项列表.
(2)ProgressDialog.一个用于显示进度圈或者进度条的dialog,继承自AlertDialog,所以它也支持按钮.
(3)DatePickerDialog.用于让用户选择日期的dialog.
(4)TimePickerDialog.用于让用户选择时间的dialog.
如果你需要定义自己的dialog,只需要继承dialog或者上面提到四个组件之一, 并且为新的dialog定义自己的布局就可以了.

2.显示dialog
(1)一个dialog总是作为某个Activity的一部分被创建和显示.创建dialog当然是在Activity的onCreateDialog方法里做了,但是在创建不同用途的dialog却有章可循,推荐的方式是使用switch...case...结构.比如一个游戏里可能需要暂停和结束两种dialog,那我们的示例代码如下:
static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;

protected Dialog onCreateDialog(int id) {
Dialog dialog;
switch(id) {
case DIALOG_PAUSED_ID:
// do the work to define the pause Dialog
break;
case DIALOG_GAMEOVER_ID:
// do the work to define the game over Dialog
break;
default:
dialog = null;
}
return dialog;
}
(2)当你想显示一个dialog的时候,使用showDialog(int id),参数id是你要显示的dialog的ID.
(3)如果想在每次打开dialog的时候显示的内容有所不同,你应该考虑使用onPrepareDialog(int,Dialog)方法.它会在每次打开dialog时被调用,而不是像
onCreateDialog那样只在创建时被调用.
(4)注意:如果你在onCreateDialog方法之外创建一个dialog,它不会默认被绑定到当前的Activity,但是你可以通过setOwnerActivity(Activity)方法来强制绑定.

3.关闭dialog
(1)当你打算关闭一个dialog时,在dialog对象上调用dismiss()方法或者直接在Activity里调用dismissDialog(int)方法都可以达到这个目的.
实际上他俩是完全一样的,下面是dismissDialog方法的代码:
public final void dismissDialog(int id) {
if (mManagedDialogs == null) {
throw missingDialog(id);

}
final Dialog dialog = mManagedDialogs.get(id);
if (dialog == null) {
throw missingDialog(id);
}
dialog.dismiss();
}
(如果你正在使用onCreateDialog(int)方法管理你所有的dialog的状态),每次使用dismissDialog(int)方法关闭dialog时,Activity还会保留此dialog的状态.如果你确信不再需要已经关闭的dialog对象或者清除先前的状态对你的程序非常重要,那么你应该使用removeDialog(int),它会清除所有指向这个dialog对象的引用并且关闭它(如果这个dialog正在显示的话).下面是removeDialog方法的代码:
public final void removeDialog(int id) {

if (mManagedDialogs == null) {
return;
}

final Dialog dialog = mManagedDialogs.get(id);
if (dialog == null) {
return;
}

dialog.dismiss();
mManagedDialogs.remove(id);//这句做了些什么呢,还没仔细看
}

(2)使用dismiss listeners
如果想在关闭dialog的时候执行某些程序,那你应该考虑使用DialogInterface.OnDismissListener.使用方法如下代码所示:
Dialog dialog = new Dialog(this);
dialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
public void onDismiss(DialogInterface dialog) {
// write your performance here 
}
});
dialog也有cancel状态,这是一种较特殊的情况.当用户点击"返回","取消"或者程序里明确调用了dialog.cancel()方法时发生.注意,这个时候,
先前注册的OnDismissListener仍然会被通知(即触发调用).如果你想发出明确的取消通知(而不是简单的关闭),那你就应该使用setOnCancelListener()方法注册一个DialogInterface.OnCancelListener来做这件事.

4.创建一个AlertDialog
AlertDialog类继承于 Dialog 类.它是系统推荐的方式,能够构造出用户界面上的大多数dialog.有如下任何一个需求时,你应该考虑使用它:
显示一行标题文本;
显示一段文本消息;
让用户选择由一个`两个或者三个按钮代表的操作;
显示一个可选项列表(checkbox button或者radio button)
AlertDialog.Builder子类用来创建一个AlertDialog.首先使用new AlertDialog.Builder(this)来创建一个Builder对象,然后使用它的公有
接口方法设置AlertDialog的所有属性.完成后可以通过builder.create()来得到新创建的dialog.下面是使用AlertDialog.Builder类来创建不同的AlertDialog的方法:
(1)带button的Dialog
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setMessage("Are you sure you want to exit?")
.setCancelable(false)
.setPositiveButton("Yes", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int id) {
MyActivity.this.finish();
}
})
.setNegativeButton("No", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int id) {
dialog.cancel();
}
});
AlertDialog alert = builder.create();
注意:这里的按钮有三类setPositiveButton,setNegativeButton,setNeutralButton, 每一类只允许添加一次, 也就是最多三个按钮.按钮的种类
名称只是帮助我们区分对待它们,与它们的实际功能(由我们自己在onClick方法里定义)无关.
(2)添加一个列表
这个比较简单,给出代码示例
final CharSequence[] items = {"Red", "Green", "Blue"};

AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setItems(items, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int item) {
Toast.makeText(getApplicationContext(), items[item], Toast.LENGTH_SHORT).show();
}
});
AlertDialog alert = builder.create();
(3)添加checkbox 和 radio 按钮
在dialog里创建多选和单选列表应分别使用setMultiChoiceItems()和setSingleChoiceItems()方法.下面是创建一个单选项列表的代码:
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() {
public void onClick(DialogInterface dialog, int item) {
Toast.makeText(getApplicationContext(), items[item], Toast.LENGTH_SHORT).show();
}
});
AlertDialog alert = builder.create();
其中,setSingleChoiceItems()方法里第二个参数的意思是默认时选中哪一项,-1表示默认不选中任何一项.
注意:这样的情况下,用户可能希望这些值能被记忆并且恢复.要持久化存储这些选项的值,须借助android的数据存取技术.
(4)创建ProgressDialog
ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "", 
"Loading. Please wait...", true);
第一个参数为应用程序的Context(上下文);第二个参数为dialog的title;第三个参数是要显示的消息文本;the last parameter is whether the progress is indeterminate.
ProgressDialog的默认样式是一个旋转的轮子.如果要创建一个能显示即时进度的工具条,需要更多一点的代码:
ProgressDialog progressDialog;
progressDialog = new ProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);
这个代码在我测试的时候不能直接运行,会报出以下异常:
E/AndroidRuntime( 278): Uncaught handler: thread main exiting due to uncaught exception
E/AndroidRuntime( 278): android.view.WindowManager$BadTokenException: Unable to add window -- token
解决办法是把第二行换成下面这样就可以了:
progressDialog = new ProgressDialog(DialogActivity.this);//这里要写程序中Activity的名字

(5)创建自定义的Dialog
根据使用基类的不同可以分作两类:
使用Dialog类构造;
使用AlertDialog类构造
两种类别的不同在于,前者的Title不能为空.如果你不设置title里的文字,它占据的空间会空着,这样显然不美观.而用后面一种方法就不会出现这种问题,不设置title,Dialog里就不显示,不影响美观.所以,还是回到那句话,更推荐使用AlertDialog组件.


5.接口收集
(1)Activity里与其相关的方法：
protected Dialog onCreateDialog(int id)
protected void onPrepareDialog(int id, Dialog dialog)
public final void showDialog(int id)
public final void dismissDialog(int id)
public final void removeDialog(int id)

(2)android.content.DialogInterface:
interface OnCancelListener
interface OnDismissListener
interface OnShowListener
interface OnClickListener
interface OnMultiChoiceClickListener
interface OnKeyListener

(3)/android-src/frameworks/base/core/java/android/app/Dialog.java类及其子类里的所有方法