Android API之CheckedTextView代码演示

封面图 • 2025-11-03 • Android开发

在 Android 开发中，`CheckedTextView` 是一个继承自 `TextView` 的控件，它支持“选中”状态（即可以显示复选框），常用于列表项中作为可选择的条目。它通常与 `AdapterView`（如 `ListView` 或 `RecyclerView`）一起使用。

下面是一个简单的 **Android API 示例**，演示如何使用 `CheckedTextView`。

---

## ✅ 示例：使用 `CheckedTextView` 在 `ListView` 中

### 1. 布局文件：`activity_main.xml`

```xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

<ListView
        android:id="@+id/listView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>
```

---

### 2. 自定义布局：`list_item.xml`

```xml
<?xml version="1.0" encoding="utf-8"?>
<CheckedTextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/checkedTextView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:textSize="18sp"
    android:padding="10dp" />
```

---

### 3. Java 代码：`MainActivity.java`

```java
package com.example.checkedtextviewdemo;

import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.CheckedTextView;
import android.widget.ListView;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {

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

ListView listView = findViewById(R.id.listView);

// 创建数据源
        String[] items = {"Item 1", "Item 2", "Item 3", "Item 4", "Item 5"};

// 使用 ArrayAdapter，但需要自定义适配器来设置 CheckedTextView
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(this, R.layout.list_item, items) {
            @Override
            public View getView(int position, View convertView, ViewGroup parent) {
                CheckedTextView view = (CheckedTextView) super.getView(position, convertView, parent);
                // 可以在这里设置选中状态等
                return view;
            }
        };

listView.setAdapter(adapter);
    }
}
```

---

### 4. 注意事项：

- `CheckedTextView` 默认会自动处理选中状态。
- 如果你想要手动控制选中状态，可以通过 `setChecked(boolean)` 方法。
- `CheckedTextView` 也支持通过 `setCheckMarkDrawable()` 设置自定义的勾选图标。

---

## ✅ 示例：手动控制选中状态

```java
CheckedTextView ctv = findViewById(R.id.checkedTextView);
ctv.setChecked(true); // 设置为已选中
ctv.setText("This is checked");
```

---

## 📌 总结

| 控件 | 功能 |
|------|------|
| `CheckedTextView` | 显示带复选框的文本，适用于列表中的可选条目 |
| `AdapterView` | 如 `ListView`、`RecyclerView`，用于展示多个 `CheckedTextView` |

如果你使用的是 `RecyclerView` 和 `ViewHolder` 模式，也可以用 `CheckedTextView` 来实现类似功能。

---

如果你需要 **Kotlin 版本** 或 **RecyclerView 实现**，我也可以为你提供。是否需要？