Android开发指南-用户界面-对话框

创建对话框 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 章节。

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

当你想要显示一个对话框时，调用 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 然后创建和定义相应的对话框。比如，想象一下一个游戏使用两个不同的对话框：一个用来指示这个游戏已经暂停而另一个来指示游戏结束。首先，为每个对话框定义一个整数：

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

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

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

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

使用消除侦听器 Using dismiss listeners

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

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

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

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

· 一个标题

· 一个文本消息

· 1 个， 2 个或 3 个按钮

· 一个可选项列表（可选的复选框或单选按钮）

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

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

增加按钮 Adding buttons

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

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

增加一个列表 Adding a list

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

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

增加复选框和单选按钮

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

要创建如右边所示的一个包含单选项列表的警告对话框，使用前面例子中相同的代码，不过需要把 setItems() 方法替换为 setSingleChoiceItems() 。

setSingleChoiceItems() 的第二个参数是一个 checkedItem 整型数值，指示了基于 0 的缺省选择项的位置。“ -1 ”代表不会有默认选择项。

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

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

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

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

显示进度条 Showing a progress bar

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

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

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

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

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

比如，你的设置可能看起来像这样：

设置很简单。大多数创建代码也用来更新进度。你可能意识到创建另外一个线程来完成这个进度报告的工作是有必要的，进度通过一个对象返回给活动的用户界面线程。如果你对如何通过一个 Handler 使用另外的线程不熟悉，请参见下面的例子：

Example ProgressDialog with a second thread

这个例子使用了另外一个线程来跟踪进程进度（计数到 100 ）。这个线程在每次进度更新时通过一个句柄 Handler 发回一条消息 Message 。主活动然后更新进度对话框。

Android开发指南-用户界面-对话框