创建对话框Creating Dialogs

对话框通常是一个显示在当前活动前面的小窗口。下面的活动失去焦点而由对话框接受所有的用户交互。对话框通常被用来当做通知或者运行中的应用程序相关的短暂活动。

Android API支持下面的对话框对象类型:

警告对话框AlertDialog

这个对话框管理0,1,2,或3个按钮,和/或一个可包含复选框和单选按钮的可选项列表。这个警告对话框能够组建大多数用户界面而且是推荐使用的对话框类型。请查看下面的创建一个警告对话框Creating an AlertDialog。

进度对话框ProgressDialog

用来显示一个进度轮或进度条。因此它是警告对话框的扩展,它也支持按钮。请查看下面的Creating a ProgressDialog 。

日期选择对话框DatePickerDialog

一个允许用户选择日期的对话框。请查看Hello DatePicker 指南。

时间选择对话框TimePickerDialog

一个允许用户选择时间的对话框。请查看Hello TimePicker 指南.

如果你想定制你自己的对话框,你可以在基础对话框对象或任何上面列举的子类对话框上进行扩展并定义一个新的布局。请查看下面的创建自定义对话框 Creating a Custom Dialog章节。

显示对话框Showing a Dialog

对话框经常作为活动Activity的一部分来创建和显示。你通常应该从活动的onCreateDialog(int) 回调方法里创建对话框。当你使用这个回调函数时,Android系统会有效的设置这个活动为每个对话框的所有者,从而自动管理每个对话框的状态并挂靠到活动上。这样,每个对话框继承这个活动的特定属性。比如,当一个对话框打开时,菜单键显示为这个活动定义的选项菜单,音量键修改活动使用的音频流。

注意: 如果你决定在onCreateDialog()方法之外创建一个对话框,它将不会被附着到活动上。不过,你可以通过 setOwnerActivity(Activity)把它附着到一个活动上。

当你想要显示一个对话框时,调用showDialog(int) 方法并传递一个唯一标识这个对话框的整数。

当对话框第一次被请求时,Android从你的活动中调用onCreateDialog(int),你应该在这里初始化这个对话框Dialog。这个回调方法被传以和showDialog(int)相同的ID。当你创建这个对话框后,在方法的最后返回这个对象。

在对话框被显示之前,Android还调用了可选的回调函数onPrepareDialog(int, Dialog). 如果你想在每一次对话框被打开时改变它的任何属性,你可以定义这个方法。这个方法在每次打开对话框时被调用,而onCreateDialog(int) 仅在对话框第一次打开时被调用。如果你不定义onPrepareDialog(),那么这个对话框将保持和上次打开时一样。这个方法也被传递以对话框的 ID,和在onCreateDialog()中创建的对话框对象。

定义onCreateDialog(int) 和 onPrepareDialog(int, Dialog) 回调函数的最佳方法是使用一个switch 语句来检查传递进来的id 参数。每个case 应该检查一个唯一的对话框ID然后创建和定义相应的对话框。比如,想象一下一个游戏使用两个不同的对话框:一个用来指示这个游戏已经暂停而另一个来指示游戏结束。首先,为每个对话框定义一个整数:

static final int DIALOG_PAUSED_ID = 0;

static final int DIALOG_GAMEOVER_ID = 1;



然后,为每一个ID用一个switch case定义这个onCreateDialog(int) 回调函数:

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;

}



注意: 在这个例子里,case语句没有具体内容,因为这超出了本章讨论范围。

当是时候显示其中之一的对话框时,使用对话框ID调用showDialog(int):

showDialog(DIALOG_PAUSED_ID);



消除对话框Dismissing a Dialog

当你准备关闭对话框时,你可以通过对这个对话框调用dismiss()来消除它。如果需要,你还可以从这个活动中调用 dismissDialog(int) 方法,这实际上将为你对这个对话框调用dismiss() 方法.

如果你想使用onCreateDialog(int) 方法来管理你对话框的状态(就如同在前面的章节讨论的那样),然后每次你的对话框消除的时候,这个对话框对象的状态将由该活动保留。如果你决定不再需要这个对象或者清除该状态是重要的,那么你应该调用removeDialog(int)。这将删除任何内部对象引用而且如果这个对话框正在显示,它将被消除。

使用消除侦听器Using dismiss listeners

如果你希望你的应用程序在一个对话框消亡的时候执行一些流程,那么你应该附着一个on-dismiss侦听器到对话框上。

首先定义DialogInterface.OnDismissListener 接口。这个接口只有一个方法,onDismiss(DialogInterface),将在对话框消亡的时候被调用。然后简单的传递你的 OnDismissListener 实现给setOnDismissListener()。

然而, 请注意对话框也可以被“取消”。这是一个表明对话框被用户显示取消的特殊情况。这将在用户按“返回”按钮时发生,或者这个对话框显示的调用 cancel() (也许通过对话框上的一个“取消”按钮)。当一个对话框被取消时,这个OnDismissListener 依然会被通知到,但是如果你希望在对话框被显示取消时被通知到(而不是通常的消除方式),那么你应该通过setOnCancelListener()注册一个DialogInterface.OnCancelListener 。

创建警告对话框Creating an AlertDialog

一个警告对话框是对话框的扩展类。它能够构建大多数对话框用户界面并且是推荐使用的对话框类型。你应该在具备如下特性的时候使用它:

·        一个标题

·        一个文本消息

·        1个,2个或3个按钮

·        一个可选项列表(可选的复选框或单选按钮)

为了创建一个警告对话框,使用AlertDialog.Builder 子类。通过AlertDialog.Builder(Context)获取一个构造器然后使用这个类的公共方法来定义警告对话框的所有属性。当得到构造器后,通过create().方法来获取警告对话框对象。

下面的题目说明了如何使用AlertDialog.Builder类来定义不同的警告对话框属性。如果你在onCreateDialog()回调函数中使用下面的代码,你可以返回结果对话框对象来显示它。

增加按钮Adding buttons

为了创建一个如右图所示的包含并行按钮的警告对话框,使用set...Button() 方法:


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();



首先,为这个对话框添加一个消息setMessage(CharSequence)。然后,开始函数链并设置该对话框为不能取消not cancelable (因此用户不能使用返回按钮关闭这个对话框)。对每个按钮,使用任一set...Button() 方法,比如setPositiveButton(),该方法接受按钮名称以及一个定义用户选中按钮后所采取动作的 DialogInterface.OnClickListener。

注意: 你仅可以为这个警告对话框添加其中一种按钮类型。也就是,你不能包含多个“确定”按钮。这限制了可能的按钮数目只能是3个:确定,中立和否定。这些名字和你按钮的实际功能是技术上无关的,但是应该可以帮助你记录做了什么。

增加一个列表Adding a list

为了创建一个带有可选项列表的警告对话框,如右边所示,可使用setItems()方法:

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();



首先,用setTitle(CharSequence)方法给对话框添加一个标题。然后,添加用setItems()添加一个可选项列表,该列表接受一组显示的items和一个DialogInterface.OnClickListener 来定义用户选中按钮后所采取动作。

增加复选框和单选按钮

要在对话框里创建一个多选项列表(checkboxes)或者单选项(radio buttons),可分别调用setMultiChoiceItems() 和setSingleChoiceItems() 方法。如果你在onCreateDialog()回调函数中创建这些可选列表,Android会帮你管理列表状态。只要这个活动是激活的,对话框会记住之前选中的items,但如果用户退出这个活动,用户选择将丢失。

注意: 为了在用户离开或暂停这个活动的时候能够保存选择,你必须通过活动生命期Activity Lifecycle来恰当的保存和恢复设置。为了永久保存选项,即使活动进程被完全终止,你需要使用数据存储Data Storage技术。

要创建如右边所示的一个包含单选项列表的警告对话框,使用前面例子中相同的代码,不过需要把setItems()方法替换为 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() 的第二个参数是一个checkedItem整型数值,指示了基于0的缺省选择项的位置。“-1”代表不会有默认选择项。

创建进度对话框Creating a ProgressDialog

进度对话框ProgressDialog是AlertDialog类的一个扩展,可以为一个未定义进度的任务显示一个旋转轮形状的进度动画,或者为一个指定进度的任务显示一个进度条。这个对话框也能提供按钮,比如一个取消下载的按钮。

可以简单的通过调用ProgressDialog.show()方法来显示一个进度对话框。比如, 可以很简单的得到右边显示的进度对话框,而不必通过onCreateDialog(int)回调管理这个对话框,如下所示:


ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "", "Loading. Please wait...", true);



第一个参数是应用程序上下文Context,第二个是对话框标题(此处为空),第三个是信息,最后这个参数表明进度是否是不确定的(这只和创建进度条有关,下一章会有描述)。

进度对话框的缺省类型是一个旋转轮,如果你想创建一个间隔进度,需要更多的代码,如下章所述。

显示进度条Showing a progress bar

使用动画进度条显示进度:

1.   用类构造器初始化进度对话框,ProgressDialog(Context)。

2.  用setProgressStyle(int)方法设置进度风格为"STYLE_HORIZONTAL"以及设置其它属性,比如消息。

3.  当你准备显示这个对话框时,调用show()或者从onCreateDialog(int)回调中返回ProgressDialog。

4.  你可以通过调用setProgress(int)设置当前进度百分比或者调用incrementProgressBy(int)方法增加进度值。

比如,你的设置可能看起来像这样:

ProgressDialog progressDialog;

progressDialog = new ProgressDialog(mContext);

progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);

progressDialog.setMessage("Loading...");

progressDialog.setCancelable(false);



设置很简单。大多数创建代码也用来更新进度。你可能意识到创建另外一个线程来完成这个进度报告的工作是有必要的,进度通过一个对象返回给活动的用户界面线程。

 



代码


package      com.amaker.test;

     import 
     android.app.Activity;
     import 
     android.app.AlertDialog;
     import 
     android.content.DialogInterface;
     import 
     android.os.Bundle;
     import 
     android.view.View;
     import 
     android.view.View.OnClickListener;
     import 
     android.widget.Button;
     import 
     android.widget.TextView;
     /** 
    
 * 
 * AlertDialog測試
     */ 
    
     public 
      
    class 
     MainActivity  
    extends 
     Activity {

     private 
     TextView myTV;
     private 
     Button myBtn;

 @Override
     public 
      
    void 
     onCreate(Bundle savedInstanceState) {
     super 
    .onCreate(savedInstanceState);
 setContentView(R.layout.main);
 myTV      = 
     (TextView)findViewById(R.id.TextView01);
 myBtn      = 
     (Button)findViewById(R.id.Button01);
     final 
     AlertDialog.Builder builder  
    = 
      
    new 
     AlertDialog.Builder( 
    this 
    );

 myBtn.setOnClickListener(     new 
     OnClickListener() {
     public 
      
    void 
     onClick(View v) {
 builder.setMessage(     " 
    真的要删除该记录吗? 
    " 
    ).setPositiveButton( 
    " 
    是 
    " 
    ,  
    new 
     DialogInterface.OnClickListener() {
     public 
      
    void 
     onClick(DialogInterface dialog,  
    int 
     which) {
 myTV.setText(     " 
    删除成功! 
    " 
    );
 }
 }).setNegativeButton(     " 
    否 
    " 
    ,  
    new 
     DialogInterface.OnClickListener() {
     public 
      
    void 
     onClick(DialogInterface dialog,  
    int 
     which) {
 myTV.setText(     " 
    取消删除! 
    " 
    );
 }
 });
 AlertDialog ad      = 
     builder.create();
 ad.show();
 }
 }
 );
 }
}


 

 

代码

package      com.amaker.test;

     import      android.app.Activity;
     import      android.app.AlertDialog;
     import      android.content.DialogInterface;
     import      android.os.Bundle;
     import      android.view.View;
     import      android.view.View.OnClickListener;
     import      android.widget.Button;
     import      android.widget.TextView;

     public       
    class 
     MainActivity  
    extends 
     Activity {
     private      TextView myTV;
     private      Button myBtn;

     public       
    void 
     onCreate(Bundle savedInstanceState) {
     super     .onCreate(savedInstanceState);
 setContentView(R.layout.main);

 myTV      =      (TextView)findViewById(R.id.TextView01);
 myBtn      =      (Button)findViewById(R.id.Button01);
     final      String[] items  
    = 
     { 
    " 
    奥尔良鸡腿堡 
    " 
    , 
    " 
    麻辣鸡腿堡 
    " 
    , 
    " 
    咖啡 
    " 
    };
     final      AlertDialog.Builder builder  
    = 
      
    new 
     AlertDialog.Builder( 
    this 
    );
 myBtn.setOnClickListener(     new      OnClickListener() {
     public       
    void 
     onClick(View v) {
     //     builder.setTitle("请点餐").setItems(items, new DialogInterface.OnClickListener() {
     //      如果改为如下方法,以单项按钮样式显示 
    
      builder.setTitle(     " 
    请点餐 
    " 
    ).setSingleChoiceItems(items, 
    - 
    1 
    ,  
    new 
     DialogInterface.OnClickListener() {
     public       
    void 
     onClick(DialogInterface dialog,  
    int 
     which) {
 myTV.setText(items[which]);
 }
 });
 AlertDialog ad      =      builder.create();
 ad.show();
 }
 });
 }
}