第三部分：Android 应用程序接口指南---第二节：UI---第六章 对话框

第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()来关闭对话框。

  本文来自jy02432443，是本人辛辛苦苦一个个字码出来的，转载请保留出处，并保留追究法律责任的权利 QQ78117253