转载自:http://www.cnblogs.com/tianjian/archive/2012/12/14/2817694.html
第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()来关闭对话框。