从零开始--系统深入学习android（实践-让我们开始写代码-Android框架学习-6.对话框）
第6章 对话框
一个对话框是一个小窗口,提示用户做出决定或输入额外的信息，一个对话框不填充屏幕并且通常用于在程序运行时中断，然后弹出通知提示用户，从而直接影响到正在运行的程序。图6-1就是对话框的外观。
图6-1
Dialog类是所有具体对话框的基类，但你应该避免直接实例化Dialog。因为可能有些现成的已经给你提供好了，比如以下几种：
◆AlertDialog
一个对话框,可以显示一个标题（可选）,三个按钮（可选）,内容的列表（可选）,或一个自定义布局。
◆DatePickerDialog或TimePickerDialog
一个对话框,其中有一个预定义的用户界面,允许用户选择一个日期或时间。
◆ProgressDialog
这个我们应该尽量避免使用，它用于显示进度条。但是，如果你如果需要显示这种加载或不确定的进度情况，更好的方法是Activity结合Progress，明确的在布局中使用ProgressBar来更新进度，以让用户明确的看到进度情况。
以上这些类定义了你对话框的风格和结构，但你也可以使用DialogFragment作为你对话框的容器。DialogFragment类提供所有创建和管理外观的控制力，它比直接调用Dialog对象中的方法更好。使用DialogFragment管理对话框可以确保它正确地处理生命周期事件，比如当用户按下后退按钮或旋转屏幕时。这个DialogFragment类还允许您重用对话框的用户界面,就像一个传统的Fragment (比如当你希望对话框在大型和小型屏幕中的UI不一样)。注意DialogFragment类在android3.0或以上版本中才有，如果你需要在低版本中使用它可以使用Support Library，添加这个库到你的应用中。一般比较新的ADT+Eclipse套装会自动把这个库添加到你的项目中。
6.1 创建一个对话框Fragment
你能完成各种各样的对话框设计：包括自定义布局和那些描述。通过DialogFragment创建一个AlertDialog并在onCreateDialog()回调方法中设置一些属性。如代码清单6-1所示：
public class FireMissilesDialogFragment extends DialogFragment { @Override public Dialog onCreateDialog(Bundle savedInstanceState) { // 使用Builder类更方便 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) { //相当于确定 } }) .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int id) { // 相当于取消 } }); // 创建AlertDialog对象并返回 return builder.create(); } }
代码清单6-1
现在当你创建完后调用show()方法，对话框出现图6-2的效果。
图6-2 一个对话框中带有一个消息和两个动作按钮
6.2 构建一个Alert Dialog
AlertDialog类允许您构建各种对话框设计。如图6-3所示, 一个警告对话框有三个区域
图6-3 对话框布局
1. 标题（Title）
这是可选的,如果你需要一个简单的信息或问题的状态，你可以不需要一个标题。
2. 内容区域
它可以显示一条消息,一个列表,或其他自定义布局。
3. 动作按钮
在一个对话框最多不应该超过3个按钮。
AlertDialog.Builder类系统了API允许你创建各种各样的内容，包括布局等，现在在返回看下代码清单6-1可能你会更清晰了。清单中还有两个按钮，如果你看到这样的格式方法如set..Button()，就是设置动作按钮了，下面让我们来看下3种按钮的不同之处：
◆Positive
这个按钮表示接受或着继续，相当于“确定”或者“OK”
◆Negative
这个按钮相当于“取消”
◆Neutral
这是个中立按钮，比如一个“以后提醒我”的功能。
每种按钮只能出现一次，不能同时出现N次。
6.2.1添加一个List
有三种可用的AlertDialog API列表：
一个传统的单选列表
一个持久化的单选列表（单选按钮）
一个持久化的多选列表（复选框）
创建一个单选列表类似于图6-4,你可以使用setItems()方法，如代码清单6-2所示：
图6-4 这个对话框里有标题和列表
@Override public Dialog onCreateDialog(Bundle savedInstanceState) { 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) { // 'which' 参数包含被选中item的索引位置 } }); return builder.create(); }
代码清单6-2
因为列表出现在对话框的内容区域里，对话框不能既显示列表又显示一个消息，所以你可以使用setTitle()设置标题以代替消息（message）。为了指定列表中的item，你可以通过数组来调用setItems()方法。或者你能使用setAdapter()来指定一个列表。它允许你使用一个ListAdapter来返回列表和动态数据。如果你选择使用ListAdapter返回一个列表，那么请一直使用Loader以便内容异步加载。关于这方面的内容在“用户界面和布局”和“装载机”章节我们已讲述过。注意：默认情况下，触摸一个list item会dissmiss掉一个对话框，除非你使用下面我们要讲述的持久化选择列表。
6.2.2添加一个持久化的单选或多选列表
为了添加一个列表的多选item或单选item，你可以使用setMultiChoiceItems()或setSingleChoiceItems()方法。例如图6-5是在一个ArrayList中使用多选item的例子。
图6-5 一个多选列表的items
@Override public Dialog onCreateDialog(Bundle savedInstanceState) { mSelectedItems = new ArrayList(); AlertDialog.Builder builder = new AlertDialog.Builder(getActivity()); builder.setTitle(R.string.pick_toppings) .setMultiChoiceItems(R.array.toppings, null, new DialogInterface.OnMultiChoiceClickListener() { @Override public void onClick(DialogInterface dialog, int which, boolean isChecked) { if (isChecked) { // 如果选择一个item，就添加一个索引 mSelectedItems.add(which); } else if (mSelectedItems.contains(which)) { // 否则，如果item已经存在就移除它 mSelectedItems.remove(Integer.valueOf(which)); } } }) // 设置动作按钮 .setPositiveButton(R.string.ok, new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int id) { // 用户点击OK，保存已选中的item结果到某处或者返回结果到已打开的对话框中 ... } }) .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int id) { ... } }); return builder.create(); }
代码清单6-3
虽然一个传统的列表和一个单选列表都提供一个“单选”动作。但如果你想要保存用户的选择，你应该使用setSingleChoiceItems()。就是说如果你稍后再次打开对话框应该表明用户当前的选择是什么，然后你使用单选按钮创建一个列表。
6.2.3创建以自定义的布局
如果你想要一个自定义的布局，那么你可以使用AlertDialog.Builder对象中的setView()方法来添加一个你创建的布局。默认情况下，自定义布局会填充对话框窗口，但你仍然能使用AlertDialog.Builder中的方法来添加动作按钮和标题。例如，图6-6和代码清单6-4所示：
图6-6 一个自定义的对话框布局
代码文件在res/layout/dialog_signin.xml中
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="wrap_content" android:layout_height="wrap_content"> <ImageView android:src="@drawable/header_logo" android:layout_width="match_parent" android:layout_height="64dp" android:scaleType="center" android:background="#FFFFBB33" android:contentDescription="@string/app_name" /> <EditText android:id="@+id/username" android:inputType="textEmailAddress" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_marginTop="16dp" android:layout_marginLeft="4dp" android:layout_marginRight="4dp" android:layout_marginBottom="4dp" android:hint="@string/username" /> <EditText android:id="@+id/password" android:inputType="textPassword" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_marginTop="4dp" android:layout_marginLeft="4dp" android:layout_marginRight="4dp" android:layout_marginBottom="16dp" android:fontFamily="sans-serif" android:hint="@string/password"/> </LinearLayout>
代码清单6-4
注意:默认情况下,当你设置一个EditText元素为“textPassword”输入类型时，字体会设置为等宽字体，因此你应该使用字体为“sans-serif”来统一匹配文本字体风格。为了在DialogFragment 中inflate布局，你可以使用getLayoutInflater()获得一个LayoutInflater并调用inflate()，然后setView()。如代码清单6-5所示：
@Override public Dialog onCreateDialog(Bundle savedInstanceState) { AlertDialog.Builder builder = new AlertDialog.Builder(getActivity()); // 获得layout inflater LayoutInflater inflater = getActivity().getLayoutInflater(); builder.setView(inflater.inflate(R.layout.dialog_signin, null)) //设置action响应 .setPositiveButton(R.string.signin, new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int id) { // todo... } }) .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int id) { LoginDialogFragment.this.getDialog().cancel(); } }); return builder.create(); }
代码清单6-5
注意：如果你想要自定义对话框，你其实可以使用Activity来作为对话框。简单的创建一个activity然后在manifest中的<activity>节点下设置它的主题（theme）为Theme.Holo.Dialog即可。如代码清单6-6所示：
<activity android:theme="@android:style/Theme.Holo.Dialog" >
代码清单6-6
就是这样。这个activity现在作为一个对话框窗口显示而不是全屏显示。
6.3 通过事件返回到对话框的Host
当用户触摸一个对话框的动作按钮或选择一个item时，你的DialogFragment可能执行必要的操作，但常常你想要传递这个事件到已经打开的对话框中的上层activity或fragment中。为了做到这些，定义一个点击事件的接口类型。然后实现接口中的方法。如代码清单6-7所示：
public class NoticeDialogFragment extends DialogFragment { public interface NoticeDialogListener { public void onDialogPositiveClick(DialogFragment dialog); public void onDialogNegativeClick(DialogFragment dialog); } NoticeDialogListener mListener; @Override public void onAttach(Activity activity) { super.onAttach(activity); try { mListener = (NoticeDialogListener) activity; } catch (ClassCastException e) { throw new ClassCastException(activity.toString() + " must implement NoticeDialogListener"); } } @Override public Dialog onCreateDialog(Bundle savedInstanceState) { // Build the dialog and set up the button click handlers 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) { // 发送positive按钮事件回调到host activity mListener.onDialogPositiveClick(NoticeDialogFragment.this); } }) .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int id) { // 发送negative按钮事件回调到host activity mListener.onDialogPositiveClick(NoticeDialogFragment.this); } }); return builder.create(); } }
代码清单6-7
代码清单6-7只是定义接口，当然我们还需要实现这个接口，下面代码清单6-8就是如何实现并运用的：
public class MainActivity extends FragmentActivity implements NoticeDialogFragment.NoticeDialogListener{ ... public void showNoticeDialog() { DialogFragment dialog = new NoticeDialogFragment(); dialog.show(getSupportFragmentManager(), "NoticeDialogFragment"); } @Override public void onDialogPositiveClick(DialogFragment dialog) { } @Override public void onDialogNegativeClick(DialogFragment dialog) { } }
代码清单6-8
6.4 显示一个对话框
当你想要显示你的对话框时，创建一个DialogFragment的实例并调用show()方法，并传递一个FragmentManager和一个标签名字。你可以通过getSupportFragmentManager()来获得一个FragmentManager。如代码清单6-9所示：
public void confirmFireMissiles() { DialogFragment newFragment = new FireMissilesDialogFragment(); newFragment.show(getSupportFragmentManager(), "missiles"); }
代码清单6-9
第二个参数，"missiles"是一个唯一的标签名，因为某些必要情况下系统用来保存和恢复fragment的状态。当然你可以通过findFragmentByTag()来获得一个fragment。
6.5 显示一个全屏对话框或作为一个嵌入式
你可能有一个UI设计，你想要一个区域用来放置这个UI，这里你用到了一个对话框，但有时候你又需要全屏显示（比如在大屏幕下可能作为标准的对话框，在小屏幕下你可能需要全屏）。DialogFragment类提供了这种灵活性。但是，你不能使用AlertDialog.Builder或其他Dialog对象来处理这种情况。如果你想要DialogFragment是可嵌入的，你必须在布局中定义对话框的UI，然后在onCreateView()回调方法中载入布局。如代码清单6-10所示（purchase_items.xml）：
public class CustomDialogFragment extends DialogFragment { @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { return inflater.inflate(R.layout.purchase_items, container, false); } @Override public Dialog onCreateDialog(Bundle savedInstanceState) { Dialog dialog = super.onCreateDialog(savedInstanceState); dialog.requestWindowFeature(Window.FEATURE_NO_TITLE); return dialog; } }
代码清单6-10
下面是一些代码,根据屏幕大小决定是否显示Fragment作为一个对话框或全屏UI，如代码清单6-11所示：
public void showDialog() { FragmentManager fragmentManager = getSupportFragmentManager(); CustomDialogFragment newFragment = new CustomDialogFragment(); if (mIsLargeLayout) { // 如果是大型布局，作为对话框显示即可 newFragment.show(fragmentManager, "dialog"); } else { // 如果是小设备，作为fragment全屏显示 FragmentTransaction transaction = fragmentManager.beginTransaction(); //指定一个过渡动画 transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); // 使用全屏就把对话框newFragment作为根view transaction.add(android.R.id.content, newFragment) .addToBackStack(null).commit(); } }
代码清单6-11
在这个例子中，mIsLargeLayout这个boolean值是我们代码检测出来的结果，其实更好的方法是在不同的文件夹下指定资源值，如下所示：
res/values/bools.xml
<!—默认boolean值 --> <resources> <bool name="large_layout">false</bool> </resources>
res/values-large/bools.xml
<!—Large屏幕下的boolean值--> <resources> <bool name="large_layout">true</bool> </resources>
然后再代码中这样获取如代码清单6-12所示：
boolean mIsLargeLayout; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mIsLargeLayout = getResources().getBoolean(R.bool.large_layout); }
代码清单6-12
6.5.1 在大屏幕下显示一个以对话框形式的activity
有个很简单的方法就是，如代码清单6-13所示：
<activity android:theme="@android:style/Theme.Holo.DialogWhenLarge" >
代码清单6-13
6.6 Dissmiss对话框
当用户触摸任何一个由AlertDialog.Builder创建动作按钮时，系统会dismiss掉对话框。当用户触摸一个对话框的itme时系统会dismiss对话框，除单选按钮或复选框之外。当然你也能手动调用DialogFragment的dismiss()的方法。如果你需要当对话框消失时，执行某些操作，你可以在DialogFragment中实现onDismiss()方法。当然有些时候你想取消一个对话框。如果用户按下返回按钮，触摸对话框外面区域或调用Dialog的cancel()方法都会执行取消操作，或者你可以在DialogFragment中实现onCancel()方法来做一些取消之前的操作。注意：系统会优先调用onDismiss()。如果你主动调用了Dialog.dismiss()或者DialogFragment.dismiss()那么系统会调用onDismiss()而不会调用onCancel()。所以通常情况下我们都使用dismiss()来关闭对话框。
FAQ QQ群213821767
