详解Dialog(二)——有关列表的构建

叁歲伎倆 2023-10-09 11:46 46阅读 0赞

上篇给大家讲了Dialog的基本元素的构建方法，今天给大家说说有关列表对话框的构建。本篇讲的所有列表项都是通过系统自带的函数生成的，对于完全自定义对话框的方法，我们会在最后一篇讲。

列表对话框主要有四种：普通列表、单选列表、双选列表、自定义视图的列表，下面我们一个个来分析。

## 一、普通列表 ##

普通列表的样式是这样的：

![SouthEast][]

要实现这样的列表样式，是通过下面的方法来实现的：

builder.setItems(CharSequence[] items, DialogInterface.OnClickListener listener)
    builder.setItems(int itemsId, DialogInterface.OnClickListener listener)

这两种方法实现的效果都是一样的，

setItems(CharSequence[] items, DialogInterface.OnClickListener listener)

这个items传进去的是一个字符串数组；

setItems(int itemsId, DialogInterface.OnClickListener listener)

这个传进去的一个itemsId，是在XML中定义好的一个字符串数组资源的ID；

下面，我们一个个看看他们的具体用法：

### 1、字符串数组 ###

下面是上图是实现上图效果的代码：

String[] mItems = {"item0", "item1", "itme2", "item3", "itme4", "item5", "item6"};
    AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
    builder.setIcon(R.drawable.ic_launcher);
    builder.setTitle("使用列表字符串");
    builder.setItems(mItems, new DialogInterface.OnClickListener() {
        @Override
        public void onClick(DialogInterface dialog, int which) {
            Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
        }
    });
    builder.create();
    builder.show();

可以看到首先构造一个mItems数组，然后在buidler.setItems直接传进去就好了。至于DialogInterface.OnClickListener()\{\}函数就是对点击事件的监听，which表示当前点击的是哪个ITEM的索引。

## 2、字符串资源ID ##

首先在xml文件夹下建一个字符串资源XML，命名为：array.xml，位置如图：

![SouthEast 1][]

然后定义一段字符串数组：

<?xml version="1.0" encoding="utf-8"?>
    <resources>
        <string-array name="dialog_items">
            <item>王菲</item>
            <item>王力宏</item>
            <item>帅哥</item>
            <item>美女</item>
        </string-array>
    </resources>

下面就是利用SetItem来生成列表了：

AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
    builder.setIcon(R.drawable.ic_launcher);
    builder.setTitle("使用Resource ID");
    builder.setItems(R.array.dialog_items, new DialogInterface.OnClickListener() {
        @Override
        public void onClick(DialogInterface dialog, int which) {
            Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
        }
    });
    builder.create();
    builder.show();

在这里的SetItems时直接将我们字符串数组的name直接设置进去，出来的效果就是这样的：

![SouthEast 2][]

## 二、单选列表 ##

单选列表的样式是这样的：

![SouthEast 3][]

要实现单选列表，主要是通过下面四个其中之一来实现的：

**方法一：**

setSingleChoiceItems(CharSequence[] items, int checkedItem, DialogInterface.OnClickListener listener)

与上面一样，传进去一个字符串数组，和初始化时选中的ITEM，构造一个单选列表

**方法二：**

setSingleChoiceItems (int itemsId, int checkedItem, DialogInterface.OnClickListener listener)

同样，与上面的例子相同，这里传进去的是一个字符串数组的资源ID，字符串数组的构造方法与上面相同，就不再赘述

**方法三：**

setSingleChoiceItems (ListAdapter adapter, int checkedItem, DialogInterface.OnClickListener listener)

这个方法是最难理解的方法，因为这里的ListAdapter并不能是普通的Adapter，不信你传一个Adapter，保证出来只是你自己的ITEM视图，旁边的单选按钮却出不来，其实这里的Adapter只是重写单选按钮旁的文字的样式，并不支持所有的Adapter,这个我会在本文最后讲述。

**方法四：**

setSingleChoiceItems (Cursor cursor, int checkedItem, String labelColumn, DialogInterface.OnClickListener listener)

这里通过传进去一个Cursor来构造对应的字符串数组，可以是数据库Cursor，也可以其它系统自带的数据Cursor,但基本上用不到，就不再讲了  
好了，关于方法三，因为下面会接着讲SetAdapter的知识，所以这部分我留在最后再讲，这里先讲下方法一和方法二：

方法一和方法二，与上例没什么区别，下面我就以方法一以例来讲讲上面的效果图是怎么实现的吧：

**代码如下：**

String[] mItems = {"攻", "受", "全能型", "不告诉你"};
    AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
    builder.setIcon(R.drawable.ic_launcher);
    builder.setTitle("你懂的");
    builder.setSingleChoiceItems(mItems, 0, new DialogInterface.OnClickListener() {
        @Override
        public void onClick(DialogInterface dialog, int which) {
            // TODO Auto-generated method stub
            Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
        }
    });
    builder.create();
    builder.show();

很简单，构造一个mItems的String字符串，然后直接传进去setSingleChoiceItems中，默认选中第一个，即索引是0的项。

# #

## 三、多选列表 ##

先看看效果图：

![SouthEast 4][]

自带的多选构造函数有如下几个：

**方法一：**

setMultiChoiceItems (CharSequence[] items, boolean[] checkedItems, DialogInterface.OnMultiChoiceClickListener listener)

一样，传进去一个ITEMS数组和对应的项目的选中与否状态的数组；

**方法二：**

setMultiChoiceItems (int itemsId, boolean[] checkedItems, DialogInterface.OnMultiChoiceClickListener listener)

这里传进去的是一个字符串数组，与第一部分相同

**方法三：**

setMultiChoiceItems (Cursor cursor, String isCheckedColumn, String labelColumn, DialogInterface.OnMultiChoiceClickListener listener)

同样，这里传进去的是一个CURSOR，可以是数据库的指针，也可以是系统自带数据的指针，基本不怎么用，就不讲了

下面以方法一为例看看多选列表的构造过程：

String[] mItems = {"经常犯二", "傻叉一枚", "逗逼", "小清纯", "沉稳大叔", "有时可爱"};
    AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
    builder.setIcon(R.drawable.ic_launcher);
    builder.setTitle("性格类型");
    builder.setMultiChoiceItems(mItems,
            new boolean[]{false, false, false, false, false, false, false},
            new DialogInterface.OnMultiChoiceClickListener() {
     
                @Override
                public void onClick(DialogInterface dialog, int which, boolean isChecked) {
                    Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
                }
            }
    );
    builder.show();

这里构造了两个数组，一个是字符串数组，另一个每项对应是否选中的boolean数组

String[] mItems = {"经常犯二", "傻叉一枚", "逗逼", "小清纯", "沉稳大叔", "有时可爱"};

对应的选中项的布尔值数组：

new boolean[]{false, false, false, false, false, false, false}

## **四、自定义列表项** ##

这节我带大家自定义列表项的实现，故名思义，就是每个ITEM都是我们自己来定义，使用我们自己的Adapter，先看看效果：

![SouthEast 5][]

要实现自定义列表主要是造下面这个函数来实现的：

setAdapter (ListAdapter adapter, DialogInterface.OnClickListener listener)

直接将我们构造好的Adapter设置进去。  
  
下面就带大家实现下图示中的视图：

### 1、构造Adapter ###

有关派生自BaseAdapter来构造ListViewAdapter的过程就不再细讲了，大家可以参考我以前的两篇文章：

**首先是单个Item的布局：（list\_item.xml）**

很简单，采用水平布局，左边一个图像，右边一个对应的TEXT，这里只是基本实现功能，大家完全可以在理解这篇文章的基础上派生出更复杂的视图

<?xml version="1.0" encoding="utf-8"?>
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:orientation="horizontal"
        android:layout_width="wrap_content"
        android:layout_height="match_parent">
        <ImageView
            android:id="@+id/item_imageview"
            android:layout_width="80dip"
            android:layout_height="80dip"
            android:scaleType="fitCenter"/>
        <TextView
            android:id="@+id/item_text"
            android:layout_width="wrap_content"
            android:layout_height="match_parent"
            android:gravity="center_vertical|left"
            android:textSize="20sp"/>
    </LinearLayout>

对应的视图类：

private class ViewHolder{
        public TextView mTvTitle;
        public ImageView mImageView;
    }

其中有两个变量，一个存储对应的TextView，另一个存储对应的ImageView；

现在我们还需要一个类来存储视图类中TextView的标题字符串，和对应ImageView的图片资源的ID值，这就是我们的数据类：

public static class DataHolder{
        public String title;
        public int ImageID;
        public DataHolder(String title,int imageID){
            this.title = title;
            this.ImageID = imageID;
        }
    }

我们先阶段性的看看我们的ListViewAdapter:

首先是派生自BaseAdapter，然后是构造函数，我们传进去一个DataHolder的列表，用来存储每个Item应该显示的内容

public class ListItemAdapter extends BaseAdapter {
        private List<DataHolder> mDataList = new ArrayList<DataHolder>();
        private LayoutInflater mInflater;
     
        public ListItemAdapter(Context context, ArrayList<DataHolder> datalist) {
            if (datalist != null && datalist.size() > 0) {
                mDataList.addAll(datalist);
            }
            mInflater = LayoutInflater.from(context);
        }
        ………………
    }

然后是最关键的getView部分：

public View getView(int position, View convertView, ViewGroup viewGroup) {
        ViewHolder holder = null;
        if (convertView == null) {
            holder=new ViewHolder();
            convertView = mInflater.inflate(R.layout.list_item, null);
            holder.mTvTitle = (TextView)convertView.findViewById(R.id.item_text);
            holder.mImageView = (ImageView)convertView.findViewById(R.id.item_imageview);
            convertView.setTag(holder);
     
        }else {
            holder = (ViewHolder)convertView.getTag();
        }
        holder.mImageView.setImageResource(mDataList.get(position).ImageID);
        holder.mTvTitle.setText(mDataList.get(position).title);
     
        return convertView;
    }

holder.mImageView.setImageResource(mDataList.get(position).ImageID);
    holder.mTvTitle.setText(mDataList.get(position).title);

最后返回convertView，让系统去做绘图  
到这里ListViewAdapter的构造过程就基本完成了，下面是完整的代码：

/**
     * Created by harvic
     * date 2015-1-11
     * */
    public class ListItemAdapter extends BaseAdapter {
        private List<DataHolder> mDataList = new ArrayList<DataHolder>();
        private LayoutInflater mInflater;
        public ListItemAdapter(Context context,ArrayList<DataHolder> datalist){
            if (datalist != null && datalist.size()>0){
                mDataList.addAll(datalist);
            }
            mInflater = LayoutInflater.from(context);
        }
        @Override
        public int getCount() {
            return mDataList.size();
        }
     
        @Override
        public Object getItem(int position) {
            return mDataList.get(position);
        }
     
        @Override
        public long getItemId(int position) {
            return position;
        }
     
        @Override
        public View getView(int position, View convertView, ViewGroup viewGroup) {
            ViewHolder holder = null;
            if (convertView == null) {
     
                holder=new ViewHolder();
     
                convertView = mInflater.inflate(R.layout.list_item, null);
                holder.mTvTitle = (TextView)convertView.findViewById(R.id.item_text);
                holder.mImageView = (ImageView)convertView.findViewById(R.id.item_imageview);
                convertView.setTag(holder);
     
            }else {
                holder = (ViewHolder)convertView.getTag();
            }
            holder.mImageView.setImageResource(mDataList.get(position).ImageID);
            holder.mTvTitle.setText(mDataList.get(position).title);
     
            return convertView;
        }
     
        private class ViewHolder{
            public TextView mTvTitle;
            public ImageView mImageView;
        }
        public static class DataHolder{
            public String title;
            public int ImageID;
            public DataHolder(String title,int imageID){
                this.title = title;
                this.ImageID = imageID;
            }
        }
    }

### 2、构造列表 ###

在MainActivity中，首先是初始化我们的ListViewAdapter,要初始化Adapter,就要首先传进去一个DataHolder的数组，所有要先构造一个DataHolder的数组

private ArrayList<ListItemAdapter.DataHolder> initDataHolder(){
        ArrayList<ListItemAdapter.DataHolder> datalist = new ArrayList<ListItemAdapter.DataHolder>();
        ListItemAdapter.DataHolder data_1 = new ListItemAdapter.DataHolder("可爱萌宠1", R.drawable.animal1);
        ListItemAdapter.DataHolder data_2 = new ListItemAdapter.DataHolder("可爱萌宠2", R.drawable.animal2);
        ListItemAdapter.DataHolder data_3 = new ListItemAdapter.DataHolder("可爱萌宠3", R.drawable.animal3);
        ListItemAdapter.DataHolder data_4 = new ListItemAdapter.DataHolder("可爱萌宠4", R.drawable.animal4);
        datalist.add(data_1);
        datalist.add(data_2);
        datalist.add(data_3);
        datalist.add(data_4);
        return datalist;
    }

在构造完成数据列表之后，下面就是构造我们的自定义的列表了，我把整个对话框显示过程整合成了一个函数createCustomList，代码如下：

private void createCustomList() {
        ArrayList<ListItemAdapter.DataHolder> dataHolders = initDataHolder();
        ListItemAdapter adapter = new ListItemAdapter(MyActivity.this, dataHolders);
        AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
        builder.setIcon(R.drawable.ic_launcher);
        builder.setTitle("可爱萌宠");
        builder.setAdapter(adapter, new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialogInterface, int which) {
                Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
            }
        });
        builder.create();
        builder.show();
    }

OK啦，到这，整个自列表项的内容就讲完了，下面再回过来给大家说说上面我们提到的有关单选列表自定义Adapter的问题。

## 五、有关单选列表自定义Adapter ##

这里主要讲的函数是第二部分单选列表中的方法三：

setSingleChoiceItems (ListAdapter adapter, int checkedItem, DialogInterface.OnClickListener listener)

在第四部分，我们构造了一个ListAdapter，这里需要的也是同样的一个ListAdapter，那我们直接将第四部分中的Adapter传进去，会是什么效果呢？

也就是利用下面的代码：

我们直接在createCustomList（）上面改一下，即把builder.setAdapter()直接换成setSingleChoiceItems() ，传进去Adpter，看看在我们定义的视图后面会不会出现一个单选按钮呢？

private void createCustomList() {
        ArrayList<ListItemAdapter.DataHolder> dataHolders = initDataHolder();
        ListItemAdapter adapter = new ListItemAdapter(MyActivity.this, dataHolders);
        AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
        builder.setIcon(R.drawable.ic_launcher);
        builder.setTitle("可爱萌宠");
        builder.setSingleChoiceItems(adapter, 0,new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialogInterface, int which) {
                Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
            }
        });
        builder.create();
        builder.show();
    }

运行一下，效果是这样的：

![SouthEast 6][]

看见了没，毛也没有，坑爹玩意，那这个函数到底是用来做什么的呢，在源码中有这样一个文件：

地址在：$android\_sdk\_home/platforms/android-x.x/data/res/layout/simple\_list\_item\_single\_choice.xml  
文件内容是这样的：

利用这个玩意是可以实现效果的，我们来试一下。

### 1、新建Adapter ###

新建一个布局文件，来保存ListVIew的每项的Item，代码如下：

在Adapter中，同样，用来保存ITEM视图的ViewHolder类，如下：

private class ViewHolder{
            public TextView  mName;
        }

因为在布局中只有一个TextView，所以在ViewHolder中也只需要一个TextView与其对应，至于类似上面的承载对应数据的DataHolder，因为我们只需要一个String字符串数组就足够了，所以就没必要再新建一个类来承载这些数据了，所以我们要构造Adapter时，传进来一个字符串数组就好了：

所以简单的构造函数为：

在构造时，传进来我们每项要显示的标题的字符串数组String\[\] items，并将其直接添加到我们的List<String> mList中。

public class SingleChoiceAdapter extends BaseAdapter {
        private LayoutInflater mInflater;
        private List<String> mList = new ArrayList<String>();
     
        public SingleChoiceAdapter(Context context, String[] items) {
            mInflater = LayoutInflater.from(context);
            if (items == null || items.length <= 0) {
                return;
            }
            for (String item : items) {
                mList.add(item);
            }
        }
     
        …………
    }

然后是最关键的getView（）部分：

public View getView(int position, View convertView, ViewGroup viewGroup) {
        ViewHolder holder = null;
        if (convertView == null) {
     
            holder=new ViewHolder();
     
            convertView = mInflater.inflate(R.layout.single_choice_item, null);
            holder.mName = (TextView)convertView.findViewById(R.id.single_list_item);
            convertView.setTag(holder);
     
        }else {
            holder = (ViewHolder)convertView.getTag();
        }
        holder.mName.setText(mList.get(position));
     
        return convertView;
    }

这段代码难度不大，就是每次绘图时，将TextView的内容设置为我们指定的字符串：

holder.mName.setText(mList.get(position));

下面是SingleChoiceAdapter完整的代码：

/**
     * Created by harvic
     * date 2015-1-11
     */
    public class SingleChoiceAdapter extends BaseAdapter {
        private LayoutInflater mInflater;
        private List<String> mList = new ArrayList<String>();
        public SingleChoiceAdapter(Context context,String[] items){
            mInflater = LayoutInflater.from(context);
            if (items == null || items.length<=0){
                return;
            }
            for(String item:items){
                mList.add(item);
            }
        }
        @Override
        public int getCount() {
            return mList.size();
        }
     
        @Override
        public Object getItem(int position) {
            return mList.get(position);
        }
     
        @Override
        public long getItemId(int position) {
            return position;
        }
     
        @Override
        public View getView(int position, View convertView, ViewGroup viewGroup) {
            ViewHolder holder = null;
            if (convertView == null) {
     
                holder=new ViewHolder();
     
                convertView = mInflater.inflate(R.layout.single_choice_item, null);
                holder.mName = (TextView)convertView.findViewById(R.id.single_list_item);
                convertView.setTag(holder);
     
            }else {
                holder = (ViewHolder)convertView.getTag();
            }
            holder.mName.setText(mList.get(position));
     
            return convertView;
        }
     
        private class ViewHolder{
            public TextView  mName;
        }
    }

然后就是使用的阶段了

### 2、构造单选列表 ###

这里首先构造SingleChoiceAdapter的实例，然后将其传入setSingleChoiceItems中，代码如下：

String[] mItems = {"攻", "受", "全能型", "不告诉你"};
    SingleChoiceAdapter adapter = new SingleChoiceAdapter(MyActivity.this,mItems);
    AlertDialog.Builder builder = new AlertDialog.Builder(MyActivity.this);
    builder.setIcon(R.drawable.ic_launcher);
    builder.setTitle("可爱萌宠");
    builder.setSingleChoiceItems(adapter, 0, new DialogInterface.OnClickListener() {
        @Override
        public void onClick(DialogInterface dialogInterface, int which) {
            Toast.makeText(MyActivity.this, "clicked:" + which, Toast.LENGTH_LONG).show();
        }
    });
    builder.create();
    builder.show();

运行出来的效果如图：

![SouthEast 7][]

看到没，这里效果是出来了，可见，在单选按钮中，定义Adapter并不是随便定义的，只能定义CheckedTextView的视图，其它是不支持的！！！！

好了，到这里本篇就结束了，下篇给大家讲讲有关自定义对话框的内容。

[SouthEast]: https://img-blog.csdn.net/20150108200448335?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 1]: https://img-blog.csdn.net/20150108201457828?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 2]: https://img-blog.csdn.net/20150108201920704?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 3]: https://img-blog.csdn.net/20150108202128640?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 4]: https://img-blog.csdn.net/20150111111119084?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 5]: https://img-blog.csdn.net/20150111113016451?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 6]: https://img-blog.csdn.net/20150111164230015?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 7]: https://img-blog.csdn.net/20150111170124156?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvaGFydmljODgwOTI1/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast