废话时间###

有一段时间没好好敲代码了，处理完手头上一些琐事，终于可以潜心修行，就从这篇简单而饱满的技术文章开始我的简书之旅吧。
最近在不同项目做了一些不同的对话框，刚好来总结一下。方便自己，帮助他人。
本文由作者三汪首发于简书。

总览###

1.什么是AlertDialog
2.AlertDialog入门以及基本使用（快速创建Dialog）
3.AlertDialog的进阶（自定义布局、位置、大小、动画、style）

1.什么是AlertDialog###

Google官方的开发文档是这样描述的：

A subclass of Dialog that can display one, two or three buttons. If you only want to display a String in this dialog box, use the setMessage() method. If you want to display a more complex view, look up the FrameLayout called "custom" and add your view to it:
FrameLayout fl = (FrameLayout) findViewById(android.R.id.custom); fl.addView(myView, new LayoutParams(MATCH_PARENT, WRAP_CONTENT));
The AlertDialog class takes care of automatically setting WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM for you based on whether any views in the dialog return true from View.onCheckIsTextEditor(). Generally you want this set for a Dialog without text editors, so that it will be placed on top of the current input method UI. You can modify this behavior by forcing the flag to your desired mode after calling onCreate(Bundle).

翻译如下（手动翻译的，可能不够信达雅）：

AlertDialog是Dialog的一个子类，可以显示一到三个button。如果你只想在对话框中显示一个字符串，使用serMessage()这个方法。如果你想要显示更复杂的视图，找到这个叫"custom"的帧布局并把你的视图添加进去：
FrameLayout fl = (FrameLayout) findViewById(android.R.id.custom); fl.addView(myView, new LayoutParams(MATCH_PARENT, WRAP_CONTENT));
AlertDialog这个类根据是否有视图从View.onCheckIsTextEditor()返回true来为你自动设置WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM通常你会想要为一个没有文本编辑栏的对话框设置这个属性，以便于该对话框被放置在当前输入法界面的顶部。你可以在调用onCreate(Bundle)以后通过设置这个flag修改这一动作。

从官方文档的描述中我们可以知道AlertDialog的这么几个信息：

• 直接继承自Dialog

• 可以有三个原生的button
• 可以显示文字也可以在原生的FrameLayout布局中添加自定义视图

官方文档没有告诉我们的是：

• 自定义布局可以不使用官方提供的FrameLayout

• 可以自定义对话框出现和消失时的动画
• 可以设置对话框的大小、位置和style

下面我们来逐一说明。

2.快速创建你的Dialog###

代码如下（可直接copy进你的项目使用）：

        AlertDialog dialog = new AlertDialog.Builder(this).create();//创建对话框
        dialog.setIcon(R.mipmap.ic_launcher);//设置对话框icon
        dialog.setTitle("这是一个AlertDialog");//设置对话框标题
        dialog.setMessage("Hello world");//设置文字显示内容
        //分别设置三个button
        dialog.setButton(DialogInterface.BUTTON_POSITIVE,"确定", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                dialog.dismiss();//关闭对话框
            }
        });
        dialog.setButton(DialogInterface.BUTTON_NEUTRAL,"点我试试", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) { }
        });
        dialog.setButton(DialogInterface.BUTTON_NEGATIVE, "取消", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                dialog.dismiss();//关闭对话框
            }
        });
        dialog.show();//显示对话框

效果图

基础对话框效果图

Tips

• AlertDialog的三个button对应DialogInterface中的三个常量，分别是：BUTTON_NEUTRAL,BUTTON_POSITIVE,BUTTON_NEGATIVE。不同的常量所对应的button位置不同。其中，BUTTON_NEUTRAL在对话框左侧，另外两个在右侧（不同版本的系统可能对应的位置不同，以实际情况为准）。

• AlertDialog dialog = new AlertDialog.Builder(this).create();的Builder()中传入的context参数必须来自activity，而不能是application的，否则会报错。
• 当你什么都不设置的时候，会弹出一个“白茫茫大地真干净”的对话框。
• 调用dismiss()方法可以关闭对话框。除了在button点击事件中，还可以用在CheckBox、RadioButton的onCheckedChanged事件中等，以实现在用户完成选择以后自动关闭对话框的功能。
• setTitle、setMessage、setPositiveButton等这类设置动作还可以用builder对象来做，写法不同，效果一样。此处不再赘述。

3.简单列表、单选列表与复选列表对话框的实现示例###

简单列表代码如下：

        //初始化字符串数组
        final String[] strArray = new String[]{"床前明月光","意识地上霜","举头望明月","低头思故乡"};
        AlertDialog.Builder builder = new AlertDialog.Builder(this);//实例化builder
        builder.setIcon(R.mipmap.ic_launcher);//设置图标
        builder.setTitle("简单列表");//设置标题
        //设置列表
        builder.setItems(strArray, new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                Toast.makeText(MainActivity.this,strArray[which],Toast.LENGTH_SHORT).show();
            }
        });
        builder.create().show();//创建并显示对话框

单选列表代码如下：

        //初始化字符串数组
        final String[] strArray = new String[]{"离离原上草","一岁一枯荣","野火烧不尽","春风吹又生"};
        final AlertDialog.Builder builder = new AlertDialog.Builder(this);//实例化builder
        builder.setIcon(R.mipmap.ic_launcher);//设置图标
        builder.setTitle("单选列表");//设置标题
        //设置单选列表
        builder.setSingleChoiceItems(strArray, 0, new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {

            }
        });
        //创建对话框
        AlertDialog dialog = builder.create();

        //设置确定按钮
        dialog.setButton(DialogInterface.BUTTON_POSITIVE,"确定", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                dialog.dismiss();
            }
        });
        dialog.show();//显示对话框

复选列表代码如下：

  //初始化字符串数组
        final String[] strArray = new String[]{"白日依山尽","黄河入海流","欲穷千里目","更上一层楼"};
        final AlertDialog.Builder builder = new AlertDialog.Builder(this);//实例化builder
        builder.setIcon(R.mipmap.ic_launcher);//设置图标
        builder.setTitle("多选列表");//设置标题
        //设置多选列表
        builder.setMultiChoiceItems(strArray, new boolean[]{false, false, false, false}, new DialogInterface.OnMultiChoiceClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which, boolean isChecked) {

            }
        });
        //创建对话框
        AlertDialog dialog = builder.create();
        //设置确定按钮
        dialog.setButton(DialogInterface.BUTTON_POSITIVE,"确定", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                dialog.dismiss();
            }
        });
        dialog.show();//显示对话框

效果图：

简单列表对话框效果图

单选列表对话框效果图

复选列表对话框效果图

4.自定义布局对话框的简单示例###

对于AlertDialog的自定义布局，官方提供了原生的FrameLayout（说明与使用方式参见前文开发文档描述部分）供大家使用。但是，FrameLayout有时候并不能满足大家的需求。因此，我们需要自己引入布局文件。本文仅提供如何通过引入布局文件来实现自定义布局的示例。

代码如下：

        //实例化布局
        View view = LayoutInflater.from(this).inflate(R.layout.item_custom,null);
        //找到并对自定义布局中的控件进行操作的示例
        EditText account = (EditText) view.findViewById(R.id.account);
        account.addTextChangedListener(new TextWatcher() {
            @Override
            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
            }

            @Override
            public void onTextChanged(CharSequence s, int start, int before, int count) {
            }

            @Override
            public void afterTextChanged(Editable s) {
            }
        });
        //创建对话框
        AlertDialog dialog = new AlertDialog.Builder(this).create();
        dialog.setIcon(R.mipmap.ic_launcher);//设置图标
        dialog.setTitle("自定义布局对话框");//设置标题
        dialog.setView(view);//添加布局
        //设置按键
        dialog.setButton(AlertDialog.BUTTON_POSITIVE, "登陆", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {

            }
        });
        dialog.setButton(AlertDialog.BUTTON_NEGATIVE, "取消", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {

            }
        });
        dialog.show();

效果图：

自定义布局对话框效果图

5.如何设置Dialog的位置、大小、动画###

通过几小段代码来说明，以供参考。

代码片段1：

        Window dialogWindow = dialog.getWindow();//获取window对象
        dialogWindow.setGravity(Gravity.BOTTOM);//设置对话框位置
        dialogWindow.setLayout(WindowManager.LayoutParams.MATCH_PARENT, WindowManager.LayoutParams.WRAP_CONTENT);//设置横向全屏
        dialogWindow.setWindowAnimations(R.style.share_animation);//设置动画

styles.xml

     <style name="share_animation" parent="android:Animation">
        <item name="@android:windowEnterAnimation">@anim/dialog_enter</item>  //进入时的动画
        <item name="@android:windowExitAnimation">@anim/dialog_exit</item>    //退出时的动画
     </style>

dialog_enter.xml

<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
    
    <translate
        android:fromYDelta="100%p"     <!--  %p指相对于父容器-->
        android:duration="600"                <!-- 持续时间-->
        />
</set>

dialog_exit.xml

<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
    
    <translate
          android:toYDelta="100%p"
          android:duration="600"    
          />
</set>

代码片段2：
(片段2与片段3转载自：angeldevil)

        /*
         * 将对话框的大小按屏幕大小的百分比设置
         */
//        WindowManager m = getWindowManager();
//        Display d = m.getDefaultDisplay(); // 获取屏幕宽、高用
//        WindowManager.LayoutParams p = dialogWindow.getAttributes(); // 获取对话框当前的参数值
//        p.height = (int) (d.getHeight() * 0.6); // 高度设置为屏幕的0.6
//        p.width = (int) (d.getWidth() * 0.65); // 宽度设置为屏幕的0.65
//        dialogWindow.setAttributes(p);

代码片段3：
(片段2与片段3转载自：angeldevil)

        Window dialogWindow = dialog.getWindow();
        WindowManager.LayoutParams lp = dialogWindow.getAttributes();
        dialogWindow.setGravity(Gravity.LEFT | Gravity.TOP);

        /*
         * lp.x与lp.y表示相对于原始位置的偏移.
         * 当参数值包含Gravity.LEFT时,对话框出现在左边,所以lp.x就表示相对左边的偏移,负值忽略.
         * 当参数值包含Gravity.RIGHT时,对话框出现在右边,所以lp.x就表示相对右边的偏移,负值忽略.
         * 当参数值包含Gravity.TOP时,对话框出现在上边,所以lp.y就表示相对上边的偏移,负值忽略.
         * 当参数值包含Gravity.BOTTOM时,对话框出现在下边,所以lp.y就表示相对下边的偏移,负值忽略.
         * 当参数值包含Gravity.CENTER_HORIZONTAL时
         * ,对话框水平居中,所以lp.x就表示在水平居中的位置移动lp.x像素,正值向右移动,负值向左移动.
         * 当参数值包含Gravity.CENTER_VERTICAL时
         * ,对话框垂直居中,所以lp.y就表示在垂直居中的位置移动lp.y像素,正值向右移动,负值向左移动.
         * gravity的默认值为Gravity.CENTER,即Gravity.CENTER_HORIZONTAL |
         * Gravity.CENTER_VERTICAL.
         * 
         * 本来setGravity的参数值为Gravity.LEFT | Gravity.TOP时对话框应出现在程序的左上角,但在
         * 我手机上测试时发现距左边与上边都有一小段距离,而且垂直坐标把程序标题栏也计算在内了,
         * Gravity.LEFT, Gravity.TOP, Gravity.BOTTOM与Gravity.RIGHT都是如此,据边界有一小段距离
         */
        lp.x = 100; // 新位置X坐标
        lp.y = 100; // 新位置Y坐标
        lp.width = 300; // 宽度
        lp.height = 300; // 高度
        lp.alpha = 0.7f; // 透明度

        // 当Window的Attributes改变时系统会调用此函数,可以直接调用以应用上面对窗口参数的更改,也可以用setAttributes
        // dialog.onWindowAttributesChanged(lp);
        dialogWindow.setAttributes(lp);

以上。
欢迎留言探讨，指正。
希望我总结的东西能够对你有所帮助。