Android自定義CheckBox CheckGroup超好用

在MaterialDialog 仿Android 5.0原生的AlertDialog樣式的對話框一文中以及詳細介紹了單選/多選對話框的用法，但是在現實開發中，我們可能需要在Activity上進行單選多選操作，於是就在MaterialDialog庫中進行了再次封裝，其中CheckBox和CheckGroup這兩個類是這次封裝的結果，接下來將詳細介紹這兩個類的用法。

首先，先看效果圖：

先看下布局文件<喎?/kf/ware/vc/" target="_blank" class="keylink">vcD4NCjxwcmUgY2xhc3M9"brush:java;">

CheckBox屬性介紹

Activity代碼

public class MainActivity extends AppCompatActivity {
    CheckGroup mCheckGroup;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mCheckGroup = (CheckGroup) findViewById(R.id.checkGroup);
        OptionWrapper optionWrapper = new OptionWrapper();
        optionWrapper.setOptions("數學", "語文", "英語", "物理", "化學");
        optionWrapper.setChecked(1, 2, 4);
        mCheckGroup.setOptionWrapper(optionWrapper);
    }

    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.look:
                List checkedText = mCheckGroup.getCheckedText();
                StringBuilder builder = new StringBuilder();
                for (CharSequence charSequence : checkedText) {
                    builder.append(charSequence).append("、");
                }
                if (builder.length() > 0)
                    builder.deleteCharAt(builder.length() - 1);
                ((TextView) findViewById(R.id.result)).setText(builder);
                break;

            case R.id.hit:
                new MaterialDialog.Builder(this)
                        .setTitle("提示")
                        .setMessage("仿原生AlertDialog樣式的對話框,目的在於解決原生的在Android 5.0下樣式丑陋問題")
                        .setPositiveButton(new MaterialDialog.OnClickListener() {
                            @Override
                            public boolean onClick(DialogInterface dialog, int which) {
                                return false;
                            }
                        })
                        .setNeutralButton("不再提示", null)
                        .setNegativeButton(null).show();
                break;
            case R.id.list:
                final String[] items = {"2016/01", "2016/02", "2016/03", "2016/04", "2016/05", "2016/06", "2016/07"};
                new MaterialDialog.Builder(this)
                        .setItems(items, new MaterialDialog.OnClickListener() {
                            @Override
                            public boolean onClick(DialogInterface dialog, int which) {
                                Toast.makeText(MainActivity.this, items[which], Toast.LENGTH_SHORT).show();
                                return false;
                            }
                        }).create().show();
                break;
            case R.id.radio:
                final String[] item2 = {"2016/01", "2016/02", "2016/03", "2016/04", "2016/05", "2016/06", "2016/07"};
                new MaterialDialog.Builder(this)
                        .setTitle("單選框")
                        .setSingleChoiceItems(item2, 2, new MaterialDialog.OnClickListener() {
                            @Override
                            public boolean onClick(DialogInterface dialog, int which) {
                                Toast.makeText(MainActivity.this, item2[which], Toast.LENGTH_SHORT).show();
                                return true;
                            }
                        }).setPositiveButton("確定", null)
                        .setNegativeButton("取消", null)
                        .setNeutralButton("不在提示", null).show();
                break;
            case R.id.check:
                final String[] item1 = {"2016/01", "2016/02", "2016/03", "2016/04", "2016/05", "2016/06", "2016/07"};
                new MaterialDialog.Builder(this)
                        .setTitle("多選框")
                        .setMultiChoiceItems(item1, new int[]{1, 2, 3}, new MaterialDialog.OnMultiChoiceClickListener() {
                            @Override
                            public void onClick(DialogInterface dialog, int which, boolean isChecked) {
                                Toast.makeText(MainActivity.this, which + "--" + isChecked, Toast.LENGTH_SHORT).show();
                            }
                        })
                        .setMCResultButton(new MaterialDialog.OnMCResultListener() {
                            @Override
                            public boolean onClick(DialogInterface dialog, List checkItems) {
                                return false;
                            }
                        })
                        .setNegativeButton("取消", null)
                        .setNeutralButton("不在提示", null).show();
                break;

        }
    }
}

可能有人會有疑問：單選/多選用原生的RadioButton、RadioGroup和CheckBox就可以實現，為什麼還要去寫這些呢？
我的回答是：原生的固然好用，但是自己寫的更好用，這個稍後會有介紹；而且原生的在Android 5.0以下手機上顯示是非常丑的，自己寫的則向下兼容到Api 10，所以即使在低版本的手機顯示也是跟高版本的手機上顯示的是一樣的界面

在這，只講解CheckBox和CheckGroup兩個類的用法，具體實現請到我的github上下載源碼閱讀，源碼上都有注解，且通俗易懂

1、CheckBox
在上面的代碼中已經有了詳細的用法，且大部分用法跟原生的RadioButton一致，例如：setChecked(Boolean),setOnCheckedChangeListener等方法都是一致的。
CheckBox的優勢在於提供了一系列自定義的熟悉，例如：自定義形狀(方形還是圓形)，自定義選中/未選中時的顏色，文本的大小，顏色等等都可以自定義，最主要的是樣式向下兼容到Api 10
CheckBox基本上可以代替原生的RadioButton和CheckBox，如有發現某些功能不能替代，請聯系我，我會加上這些功能。

2、CheckGroup
CheckGroup繼承於ListView，所以它其實就是一個ListView，通過列表去展示單選/多選列表

mCheckGroup = (CheckGroup) findViewById(R.id.checkGroup);
OptionWrapper optionWrapper = new OptionWrapper();//Option的封裝類
optionWrapper.setOptions("數學", "語文", "英語", "物理", "化學");
optionWrapper.setChecked(1, 2, 4);//默認選中position為1 2 4的選項
mCheckGroup.setShape(CheckGroup.SQUARE);//畫方形,圓形傳:CheckGroup.CIRCLE
mCheckGroup.setOptionWrapper(optionWrapper);

通過以上代碼就可以在Activity上展示單選/多選列表，如果要拿到選擇結果，只需調用

List checkedText = mCheckGroup.getCheckedText();

就可以拿到已選擇的列表的文本集合，或者調用

 List checkedIndex = mCheckGroup.getCheckedIndex();

就可以拿到已選擇的列表的下標position集合，亦可調用

 List

就可以拿到已選擇的列表的對象集合，Option是一個實體累，OptionWrapper是對Option的一個簡單封裝類，兩個類裡面都是只有3個字段而已，代碼就不貼了，可以自己下載源碼查看。

如需要把列表設置為單選列表，只需要在構造方法中傳入一個true即可，例如：

OptionWrapper optionWrapper = new OptionWrapper(true);

如果在單選時，通過optionWrapper.setChecked(1, 2, 4);方法設置了多個默認選中的選項，則只會取第一個有效值做為默認選中的選項；
如果在多選時，亦通過optionWrapper.setChecked(1, 2, 4);方法設置了n個默認選中的選項，假設共有10個選項，其中n>10，則會取前10個有效值做為默認選中的選項。何為有效值，請看代碼：

    /**
     * 設置默認選中的item

     * 注:此方法一定要在setOptions之後調用才會有效

     * 單選時,默認取第一個有效值做為默認的選中
     *
     * @param positions 選中item的position集合
     */
    public void setChecked(List positions) {
        if (positions == null || positions.size() == 0) return;
        for (int position : positions) {
            //當用戶傳過來的position大於等於集合的長度時,認為是無效值
            if (position >= mOptions.size()) continue;
            mOptions.get(position).setCheck(true);
            if (isSingleChoice) break;
        }
    }

如需設置監聽器,調用如下代碼：

        mCheckGroup.setOnChangeListener(new CheckGroup.OnChangeListener() {
            @Override
            public void onChange(AdapterView parent, View view, int position) {

            }
        });

監聽器看著眼熟是不是？沒錯，裡面的3個參數都是從ListView 的OnItemClickListener監聽器中傳過去的，因為CheckGroup繼承ListView，本質上就是一個ListView。

好了，基本就介紹到這裡了，怎麼樣，用起來是不是更簡單，更順手（沒有？那好吧，我會繼續努力的）

本人小白一個，各位大神如發現錯誤之處，請指出，本人感激不盡。

源碼下載：https://github.com/liujingxing/MaterialDialogApplication