对话框 DialogFragment

对话框是提示用户作出决定或输入额外信息的小窗口。
对话框不会填充屏幕，通常用于需要用户采取行动才能继续执行的模式事件。

通常将 DialogFragment 用作对话框的容器，通过fragment实现dialog的好处是：
activity配置改变（例如转向）进行重构的情况下，fragment管理器能够自动重构，恢复原来的状态，无需人工干预，并且能够它能正确处理生命周期事件

创建

---

通过newInstance()创建实例，并返回

1. 通过缺省构造函数创建对象
2. 将传递的信息设置为fragment的参数
3. 返回对象

public class MyDialogFragment extends DialogFragment {

    public static MyDialogFragment newInstance(int num) {
        MyDialogFragment f = new MyDialogFragment();

        Bundle args = new Bundle();
        args.putInt("num", num);
        f.setArguments(args);

        return f;
    }

在onCreate回调中可以设置对话框的style、theme等属性，恢复保存的数据等

setCancelable(boolean cancelable)

控制对话框是否可以取消
参数为true，点击dialog覆盖不到的activity的空白或按返回键，就取消，依次执行onCancel()和onDismiss()回调
如参数为false，则按空白处或返回键无反应
默认为true，可以取消

setStyle(int style, int theme)

设置dialog的显示风格
例如style为STYLE_NO_TITLE，将不显示title
theme为0，表示由系统选择合适的theme。
风格也可以在资源文件的styles.xml文件中自己设定，然后配置进来

    @Override 
    public void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState); 
        if(savedInstanceState != null){
        ...
        }

        setCancelable(false); 
       
        int style = DialogFragment.STYLE_NO_TITLE；
        int theme =android.R.style.Theme_Holo_Light_Dialog; 
        setStyle(style,theme);  
    }  
...
}

通过onCreateView()设置UI和按键反馈

---

自定义对话框时通常重载Fragment的onCreateView(LayoutInflater, ViewGroup, Bundle)，返回一个View，实现dialog的UI

1. 通过inflate，根据layout XML定义，创建view

2. 对view中的组件进行绑定、设置 （findViewById）

    @Override 
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 
        
        View v = inflater.inflate(R.layout.prompt_dialog, container,false); 
        TextView tv = (TextView)v.findViewById(R.id.prompt_message); 
        tv.setText(getPrompt()); 
      
        Button dismissBtn = (Button)v.findViewById(R.id.button_dismiss); 
        dismissBtn.setOnClickListener(this);          
        Button saveBtn = (Button)v.findViewById(R.id.button_save); 
        saveBtn.setOnClickListener(this);          

        return v; 
    } 

通过onCreateDialog()创建对话框UI

对于简单的对话框，可以通过AlterDialog.Builder直接创建对话框的UI,例如警告提醒，最后返回一个Dialog

    @Override
    public Dialog onCreateDialog(final Bundle savedInstanceState) {
        AlertDialog.Builder b = new AlertDialog.Builder(getActivity()) 
                                    .setTitle(R.string.select) 
                                    .setView(initView())  //setMessage(getMessage()) 
                                    .setPositiveButton(android.R.string.ok, this)  //设置回调函数 
                                    .setNegativeButton(android.R.string.cancel,this); //设置回调函数
                                    .setNeutralButton(R.string.refresh, null);//中性按钮
 
        builder.setPositiveButton(android.R.string.ok, mDialogClickListener);
        builder.setNegativeButton(android.R.string.cancel, mDialogClickListener);
        builder.setNeutralButton(R.string.refresh, null);

        final Dialog dialog = builder.create();

        dialog.setCancelable(true);
        dialog.setCanceledOnTouchOutside(true);

        return dialog;
    }

set...Button()方法需要一个按钮标题（由字符串资源提供）和一个 DialogInterface.OnClickListener接口实现，用于定义用户按下该按钮时执行的操作。

调用 setView()将自定义布局放入对话框

final View rootView = getActivity().getLayoutInflater().inflate(R.layout.XXXXX, null);

显示和关闭对话框

---

显示有两个函数，两个方法内部都调用了 add()和commit()函数

1. public void show(FragmentManager manager, String tag)
2. public int show(FragmentTransaction transaction, String tag)
   对于将fragment transaction作为参数的方式，在调用show()之前，可通过fragment transaction进行控制，如加入到back stack中

void showDialog() {

    //清除已经存在的，同样的fragment
    FragmentTransaction ft = getFragmentManager().beginTransaction();
    Fragment prev = getFragmentManager().findFragmentByTag("dialog");
    if (prev != null) {
        ft.remove(prev);
    }
    ft.addToBackStack(null);

    // Create and show the dialog.
    DialogFragment newFragment = MyDialogFragment.newInstance();
    newFragment.show(ft, "dialog");
}

关闭
dismiss() 内部执行 FragmentTransaction的 remove()和commit() 并触发onDismiss()回调函数。如果back stack堆栈有该dialog，会将其弹出来

将事件传递回对话框的宿主

---

public class NoticeDialogFragment extends DialogFragment {

    /* 创建对话框片段的Activity实现此接口，用来接收回调事件
     * 每个方法传递DialogFragment，用来查询信息 */
    public interface NoticeDialogListener {
        public void onDialogPositiveClick(DialogFragment dialog);
        public void onDialogNegativeClick(DialogFragment dialog);
    }

    // 接口实例来传递动作事件
    NoticeDialogListener mListener;

    // 方法来实例化NoticeDialogListener
    @Override
    public void onAttach(Activity activity) {
        super.onAttach(activity);
        // Verify that the host activity implements the callback interface
        try {
            // Instantiate the NoticeDialogListener so we can send events to the host
            mListener = (NoticeDialogListener) activity;
        } catch (ClassCastException e) {
            // The activity doesn't implement the interface, throw exception
            throw new ClassCastException(activity.toString()
                    + " must implement NoticeDialogListener");
        }
    }
    ...
}

Reference

---

Android Developers:对话框
DialogFragment
DialogFragment详解