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

在android开发当中，在界面上弹出一个dialog对话框使我们经常需要做的，本篇随笔将详细的讲解dialog对话框这个概念，包括定义不同样式的对话框。

一、dialog

我们首先来看看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就是一个在屏幕上弹出一个可以让用户做出一个选择，或者输入额外的信息的对话框，一个对话框并不会沾满我们整个的屏幕，并且通常用于模型事件当中需要用户做出一个决定后才会继续执行。

dialog类是dialog对话框的基类，但是我们应该避免直接使用这个类来实例化一个dialog对话框，我们应当使用其子类来得到一个对话框：

java.lang.object
   ↳     android.app.dialog

known direct subclasses

alertdialog, characterpickerdialog, mediaroutechooserdialog, mediaroutecontrollerdialog, presentation

known indirect subclasses

datepickerdialog, progressdialog, timepickerdialog

我们看到，dialog有很多的子类实现，所以我们要定义一个对话框，使用其子类来实例化一个即可，而不要直接使用dialog这个父类来构造。

二、alertdialog

今天我们重点要来了解的就是alertdialog对话框，我们看到，alertdialog是dialog的一个直接子类。

使用alertdialog，我们可以显示一个标题，最多3个按钮操作，以及一组选择框或者是自己定义的弹出框。

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

①区域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的点点滴滴。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。