Android控件CheckBox

封面图 • 2025-10-17 • Android开发

在 Android 开发中，`CheckBox` 是一个常用的 UI 控件，用于让用户选择一个或多个选项。它通常用于表示“是/否”、“开启/关闭”或者多选的场景。

---

## 一、CheckBox 简介

- **功能**：允许用户选择一个或多个选项（支持多选）。
- **控件类型**：`android.widget.CheckBox`
- **XML 布局文件中使用**：`<CheckBox>` 标签
- **Java/Kotlin 中使用**：通过 `findViewById()` 获取控件实例

---

## 二、XML 中使用 CheckBox

```xml
<CheckBox
    android:id="@+id/myCheckBox"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="我同意条款" />
```

---

## 三、Java 中操作 CheckBox

### 1. 获取控件并设置监听器

```java
CheckBox checkBox = findViewById(R.id.myCheckBox);

checkBox.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
    @Override
    public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
        if (isChecked) {
            // 用户勾选了该选项
            Toast.makeText(MainActivity.this, "已勾选", Toast.LENGTH_SHORT).show();
        } else {
            // 用户取消勾选
            Toast.makeText(MainActivity.this, "未勾选", Toast.LENGTH_SHORT).show();
        }
    }
});
```

### 2. 获取当前状态

```java
boolean isCheck = checkBox.isChecked();
```

---

## 四、Kotlin 中操作 CheckBox

### 1. 使用 lambda 表达式设置监听器

```kotlin
val checkBox: CheckBox = findViewById(R.id.myCheckBox)

checkBox.setOnCheckedChangeListener { _, isChecked ->
    if (isChecked) {
        Toast.makeText(this, "已勾选", Toast.LENGTH_SHORT).show()
    } else {
        Toast.makeText(this, "未勾选", Toast.LENGTH_SHORT).show()
    }
}
```

### 2. 获取当前状态

```kotlin
val isChecked = checkBox.isChecked
```

---

## 五、CheckBox 的常用属性（XML）

| 属性名 | 说明 |
|--------|------|
| `android:text` | 设置文本内容 |
| `android:checked` | 设置默认是否选中（true/false） |
| `android:buttonTint` | 设置复选框颜色 |
| `android:enabled` | 是否可用 |

示例：

```xml
<CheckBox
    android:id="@+id/myCheckBox"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="记住我"
    android:checked="true"
    android:buttonTint="#FF0000" />
```

---

## 六、CheckBox 和 Switch 的区别

| 特性 | CheckBox | Switch |
|------|----------|--------|
| 外观 | 方形图标 | 圆形滑动条 |
| 使用场景 | 多选、布尔值 | 开关控制（如 Wi-Fi、蓝牙） |
| 默认状态 | 可设置为 checked | 通常用 isChecked 控制 |

---

## 七、常见问题

### 1. 如何设置默认选中？

在 XML 中使用 `android:checked="true"` 或者在 Java/Kotlin 中调用 `setChecked(true)`。

### 2. 如何禁用 CheckBox？

使用 `setEnabled(false)` 或在 XML 中设置 `android:enabled="false"`。

### 3. 如何动态修改文本？

```java
checkBox.setText("新的文本");
```

---

## 八、总结

- `CheckBox` 是用于多选或布尔选择的控件。
- 支持通过 XML 或代码进行设置和监听。
- 常用于表单提交、设置选项等场景。
- 与 `Switch` 类似，但外观和使用场景略有不同。

如果你有具体的使用场景或问题，可以告诉我，我可以提供更详细的示例或解决方案。