Android UI系列-----Dialog对话框

时间 2019-11-06

原文原文链接

您能够经过点击 右下角 的按钮 来对文章内容做出评价, 也能够经过左下方的 关注按钮 来关注个人博客的最新动态。 

若是文章内容对您有帮助, 不要忘记点击右下角的 推荐按钮 来支持一下哦   

若是您对文章内容有任何疑问, 能够经过评论或发邮件的方式联系我: 501395377@qq.com  / lzp501395377@gmail.com

若是须要转载，请注明出处，谢谢！！

在Android开发当中，在界面上弹出一个Dialog对话框使咱们常常须要作的，本篇随笔将详细的讲解Dialog对话框这个概念，包括定义不一样样式的对话框。java

1、Dialogandroid

咱们首先来看看android官方文档对Dialog的介绍数组

A dialog is a small window that prompts the user to make a decision or enter additional information. A dialog does not fill the screen and is normally used for modal events that require users to take an action before they can proceed.

dialog就是一个在屏幕上弹出一个可让用户作出一个选择，或者输入额外的信息的对话框，一个对话框并不会沾满咱们整个的屏幕，而且一般用于模型事件当中须要用户作出一个决定后才会继续执行。app

Dialog类是dialog对话框的基类，可是咱们应该避免直接使用这个类来实例化一个dialog对话框，咱们应当使用其子类来获得一个对话框：ide

java.lang.Object
   ↳     android.app.Dialog

Known Direct Subclasses
AlertDialog, CharacterPickerDialog, MediaRouteChooserDialog, MediaRouteControllerDialog, Presentation
 Known Indirect Subclasses
DatePickerDialog, ProgressDialog, TimePickerDialog

咱们看到，Dialog有不少的子类实现，因此咱们要定义一个对话框，使用其子类来实例化一个便可，而不要直接使用Dialog这个父类来构造。布局

2、AlertDialog学习

今天咱们重点要来了解的就是AlertDialog对话框，咱们看到，AlertDialog是Dialog的一个直接子类。ui

使用AlertDialog，咱们能够显示一个标题，最多3个按钮操做，以及一组选择框或者是本身定义的弹出框。this

这里借用android的官方文档提供的一个图来看看AlertDialog框的组成：spa

①区域1那里就是定义弹出框的头部信息，包括标题名或者是一个图标。

②区域2那里是AlertDialog对话框的content部分，在这里咱们能够设置一些message信息，或者是定义一组选择框，还能够定义咱们本身的布局弹出框。

③区域3那里使咱们的Action Buttons部分，这里咱们能够定义咱们的操做按钮。

说到Action Buttons这里要特别注意一下：

在AlertDialog中，定义按钮都是经过 setXXXButton 方法来完成，其中一共有3种不一样的Action Buttons供咱们选择：

1.setPositiveButton(CharSequence text, DialogInterface.OnClickListener listener)
这是一个至关于OK、肯定操做的按钮，

2.setNegativeButton (CharSequence text, DialogInterface.OnClickListener listener)
这是一个至关于取消操做的按钮。

3. setNeutralButton (CharSequence text, DialogInterface.OnClickListener listener)
这个是至关于一个忽略操做的按钮。

咱们每一种action buttons最多只能出现一个，即弹出对话框最多只能出现一个PositiveButton。

接下来咱们经过一个一个的具体实例来看看咱们经常使用的几种AlertDialog对话框。

1.弹出一个警告框，并有三个按钮可选择

咱们来看看代码部分：

button.setOnClickListener(new OnClickListener()
        {
            @Override
            public void onClick(View v)
            {
                //    经过AlertDialog.Builder这个类来实例化咱们的一个AlertDialog的对象
                AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
                //    设置Title的图标
                builder.setIcon(R.drawable.ic_launcher);
                //    设置Title的内容
                builder.setTitle("弹出警告框");
                //    设置Content来显示一个信息
                builder.setMessage("肯定删除吗？");
                //    设置一个PositiveButton
                builder.setPositiveButton("肯定", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        Toast.makeText(MainActivity.this, "positive: " + which, Toast.LENGTH_SHORT).show();
                    }
                });
                //    设置一个NegativeButton
                builder.setNegativeButton("取消", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        Toast.makeText(MainActivity.this, "negative: " + which, Toast.LENGTH_SHORT).show();
                    }
                });
                //    设置一个NeutralButton
                builder.setNeutralButton("忽略", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        Toast.makeText(MainActivity.this, "neutral: " + which, Toast.LENGTH_SHORT).show();
                    }
                });
                //    显示出该对话框
                builder.show();
            }
        });

咱们若是要建立一个AlertDialog对话框，须要使用AlertDialog的一个内部类，即AlertDialog.Builder来构建一个AlertDialog的对话框，而后经过setXX方法来设置咱们想要显示的内容便可。

咱们看到，咱们一共设置了3个action buttons，每个button都为其绑定了一个 DialogInterface.OnClickListener() 的监听事件，而后在里面经过Toast吐司对话框(这个在后面随笔中会讲解)来弹出一下咱们的一些信息，which方法表示的是action button所表明的int值：

positive:  -1
negative:  -2
neutral:  -3

咱们能够知道，which=-1就表示点击的是肯定按钮，-2表示点击的是取消按钮，-3表示点击的是忽略按钮。

2.下拉列表弹出框

关键代码以下：

button2.setOnClickListener(new OnClickListener()
        {
            @Override
            public void onClick(View arg0)
            {
                AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
                builder.setIcon(R.drawable.ic_launcher);
                builder.setTitle("选择一个城市");
                //    指定下拉列表的显示数据
                final String[] cities = {"广州", "上海", "北京", "香港", "澳门"};
                //    设置一个下拉的列表选择项
                builder.setItems(cities, new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        Toast.makeText(MainActivity.this, "选择的城市为：" + cities[which], Toast.LENGTH_SHORT).show();
                    }
                });
                builder.show();
            }
        });

在这里咱们经过 setItems(CharSequence[] items, DialogInterface.OnClickListener listener) 方法来设置咱们的一个下拉列表框。注意：由于下拉列表框或者是下拉多选框这些都是显示在Content中的，因此message和下拉列表框这些是不可以同时存在的。

咱们也能够给其绑定一个DialogInterface.OnClickListener监听器，当选中一个选项时，对话框就会消失掉。这里的which表明的是下拉列表的每一个选项的索引，经过这个咱们能够轻松获得用户选中的是哪个选项。

3.弹出一个下拉单选框

button3.setOnClickListener(new OnClickListener()
        {
            @Override
            public void onClick(View v)
            {
                AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
                builder.setIcon(R.drawable.ic_launcher);
                builder.setTitle("请选择性别");
                final String[] sex = {"男", "女", "未知性别"};
                //    设置一个单项选择下拉框
                /**
                 * 第一个参数指定咱们要显示的一组下拉单选框的数据集合
                 * 第二个参数表明索引，指定默认哪个单选框被勾选上，1表示默认'女' 会被勾选上
                 * 第三个参数给每个单选项绑定一个监听器
                 */
                builder.setSingleChoiceItems(sex, 1, new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        Toast.makeText(MainActivity.this, "性别为：" + sex[which], Toast.LENGTH_SHORT).show();
                    }
                });
                builder.setPositiveButton("肯定", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        
                    }
                });
                builder.setNegativeButton("取消", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        
                    }
                });
                builder.show();
            }
        });

注意：在弹出下拉单选框时，当咱们选中一个选项，对话框是不会消失的，咱们须要点击action button才能让对话框消失。

4.弹出一个下拉多选框

button4.setOnClickListener(new OnClickListener()
        {
            @Override
            public void onClick(View v)
            {
                AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
                builder.setIcon(R.drawable.ic_launcher);
                builder.setTitle("爱好");
                final String[] hobbies = {"篮球", "足球", "网球", "斯诺克"};
                //    设置一个单项选择下拉框
                /**
                 * 第一个参数指定咱们要显示的一组下拉多选框的数据集合
                 * 第二个参数表明哪几个选项被选择，若是是null，则表示一个都不选择，若是但愿指定哪个多选选项框被选择，
                 * 须要传递一个boolean[]数组进去，其长度要和第一个参数的长度相同，例如 {true, false, false, true};
                 * 第三个参数给每个多选项绑定一个监听器
                 */
                builder.setMultiChoiceItems(hobbies, null, new DialogInterface.OnMultiChoiceClickListener()
                {
                    StringBuffer sb = new StringBuffer(100);
                    @Override
                    public void onClick(DialogInterface dialog, int which, boolean isChecked)
                    {
                        if(isChecked)
                        {
                            sb.append(hobbies[which] + ", ");
                        }
                        Toast.makeText(MainActivity.this, "爱好为：" + sb.toString(), Toast.LENGTH_SHORT).show();
                    }
                });
                builder.setPositiveButton("肯定", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        
                    }
                });
                builder.setNegativeButton("取消", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        
                    }
                });
                builder.show();
            }
        });

咱们看到在设置下拉多选框时使用的是setMultiChoiceItems方法，其各个参数的含义，在上面代码中已经阐述了。
一样，对于下拉多选框，当咱们选中其中一个选项时，对话框是不会消失的，只有点击了action button才会消失。

5.自定义弹出对话框

对于自定义弹出对话框，咱们就须要本身指定一个自定义的布局文件了，咱们就给出一个最简单的输入用户名和密码的两个EditText：

dialog.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    
    <EditText 
        android:id="@+id/username"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="username"/>
    
    <EditText
        android:id="@+id/password"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@id/username"
        android:hint="password"
        android:inputType="textPassword"/>

</RelativeLayout>

关键代码：

button5.setOnClickListener(new OnClickListener()
        {
            @Override
            public void onClick(View v)
            {
                AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.this);
                builder.setIcon(R.drawable.ic_launcher);
                builder.setTitle("请输入用户名和密码");
                //    经过LayoutInflater来加载一个xml的布局文件做为一个View对象
                View view = LayoutInflater.from(MainActivity.this).inflate(R.layout.dialog, null);
                //    设置咱们本身定义的布局文件做为弹出框的Content
                builder.setView(view);
                
                final EditText username = (EditText)view.findViewById(R.id.username);
                final EditText password = (EditText)view.findViewById(R.id.password);
                
                builder.setPositiveButton("肯定", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        String a = username.getText().toString().trim();
                        String b = password.getText().toString().trim();
                        //    将输入的用户名和密码打印出来
                        Toast.makeText(MainActivity.this, "用户名: " + a + ", 密码: " + b, Toast.LENGTH_SHORT).show();
                    } 
                });
                builder.setNegativeButton("取消", new DialogInterface.OnClickListener()
                {
                    @Override
                    public void onClick(DialogInterface dialog, int which)
                    {
                        
                    }
                });
                builder.show();
            }
        });

咱们看到，经过自定义弹出框，咱们首先须要写一个xml的布局文件，而后在里面定义咱们的布局，咱们不须要在布局文件里定义Button按钮，能够经过 AlertDialog.Builder 来设置 action buttons。

经过 View view = LayoutInflater.from(MainActivity.this).inflate(R.layout.dialog, null); 咱们能够将咱们的布局文件加载进来，获得一个View对象，而后经过 AlertDialog.Builder 的setView方法来设置咱们的自定义弹出框

总结：到这里，基本上将AlertDialog详细的讲解完了，本篇随笔主要讲解了Dialog弹出框的基本概念以及详细讲解了AlertDialog这个弹出框，包括定义一个基本的弹出警告框、下拉列表框、下拉多选框等等。后续的随笔将会继续记录学习Android的点点滴滴。