复选框

复选框可让用户从一系列选项中选择一个或多个选项。通常,您应以垂直列表形式显示每个复选框选项。

要创建各个复选框选项,请在布局中创建一个 CheckBox。由于一组复选框选项可让用户选择多个项目,因此每个复选框都是单独管理的,您必须为每个复选框注册点击监听器。

关键类如下:

响应点击事件

当用户选中复选框时,CheckBox 对象会收到点击事件。

要为复选框定义点击事件处理脚本,请将 android:onClick 属性添加到 XML 布局中的 <CheckBox> 元素。此属性的值必须是为了响应点击事件而调用的方法的名称。随后,托管布局的 Activity 必须实现相应的方法。

例如,以下是采用列表形式的几个 CheckBox 对象:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <CheckBox android:id="@+id/checkbox_meat"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/meat"
        android:onClick="onCheckboxClicked"/>
    <CheckBox android:id="@+id/checkbox_cheese"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/cheese"
        android:onClick="onCheckboxClicked"/>
</LinearLayout>

在托管此布局的 Activity 内,以下方法可处理两个复选框的点击事件:

Kotlin

fun onCheckboxClicked(view: View) {
    if (view is CheckBox) {
        val checked: Boolean = view.isChecked

        when (view.id) {
            R.id.checkbox_meat -> {
                if (checked) {
                    // Put some meat on the sandwich
                } else {
                    // Remove the meat
                }
            }
            R.id.checkbox_cheese -> {
                if (checked) {
                    // Cheese me
                } else {
                    // I'm lactose intolerant
                }
            }
            // TODO: Veggie sandwich
        }
    }
}

Java

public void onCheckboxClicked(View view) {
    // Is the view now checked?
    boolean checked = ((CheckBox) view).isChecked();

    // Check which checkbox was clicked
    switch(view.getId()) {
        case R.id.checkbox_meat:
            if (checked)
                // Put some meat on the sandwich
            else
                // Remove the meat
            break;
        case R.id.checkbox_cheese:
            if (checked)
                // Cheese me
            else
                // I'm lactose intolerant
            break;
        // TODO: Veggie sandwich
    }
}

您在 android:onClick 属性中声明的方法必须具有完全如上所示的签名。具体而言,该方法必须满足以下条件:

  • 公开
  • 返回 void
  • View 指定为其唯一的参数(这将是被点击的 View

提示:如果需要自行更改复选框状态,请使用 setChecked(boolean)toggle() 方法。