AndroidAPI_中文文档
一、TextView的API 中文文档
1.1 结构
java.lang.Object
↳ android.view.View
↳ android.widget.TextView
直接子类：
Button, CheckedTextView, Chronometer, DigitalClock, EditText
间接子类：
AutoCompleteTextView, CheckBox, CompoundButton,
ExtractEditText,MultiAutoCompleteTextView, RadioButton, ToggleButton
1.2 API
### Android 2.2 API中文文档 —— TextView详解
#### 1. TextView的API中文文档
##### 1.1 结构
TextView是Android中用于显示文本的重要组件之一。它继承自`View`类，位于`android.widget`包下。根据提供的文档结构，我们可以清晰地看到TextView与其他组件之间的关系：
- `java.lang.Object` (所有Java类的基类)
- `android.view.View` (所有视图组件的基类)
- `android.widget.TextView` (用于显示文本的视图)
`TextView`有一些直接和间接的子类，这些子类扩展了基本的文本显示功能，提供了更多的特性和用途：
- **直接子类**：
- `Button`：用于创建按钮。
- `CheckedTextView`：用于创建可以被选中的文本视图。
- `Chronometer`：用于显示计时器。
- `DigitalClock`：用于显示数字时钟。
- `EditText`：用于创建可编辑的文本输入框。
- **间接子类**：
- `AutoCompleteTextView`：提供自动完成建议的文本输入框。
- `CheckBox`：用于创建复选框。
- `CompoundButton`：用于创建复合按钮（如单选按钮、复选框等）。
- `ExtractEditText`：用于从网页中提取文本的输入框。
- `MultiAutoCompleteTextView`：提供多选择自动完成建议的文本输入框。
- `RadioButton`：用于创建单选按钮。
- `ToggleButton`：用于创建开关按钮。
##### 1.2 API
接下来详细介绍TextView的一些常用属性及其功能：
- **android:autoLink**
- 用途：设置文本中的URL链接、电子邮件地址、电话号码或地图位置是否显示为可点击的链接。
- 可选值包括：`none`（不启用链接）、`web`（仅链接网址）、`email`（仅链接电子邮件地址）、`phone`（仅链接电话号码）、`map`（仅链接地图位置）和`all`（链接所有类型）。
- **android:autoText**
- 用途：设置是否在输入时自动进行拼写纠正。
- 注意事项：此属性仅在用户通过输入法输入时生效，TextView本身不支持此功能。
- **android:bufferType**
- 用途：指定通过`getText()`方法获取的文本类型。
- 选项包括：
- `editable`：类似`StringBuilder`，支持追加字符。
- `spannable`：允许对特定文本区间应用样式。
- **android:capitalize**
- 用途：设置英文文本的大写规则。
- 注意事项：此属性需结合输入法使用，直接在TextView上设置无效。
- **android:cursorVisible**
- 用途：设置光标是否可见。
- 默认值为`true`（可见）。
- **android:digits**
- 用途：设置允许输入的字符集。
- 示例：`"1234567890.+-*/%\n()"`。
- **android:drawableBottom/android:drawableLeft/android:drawableRight/android:drawableTop**
- 用途：在文本下方、左侧、右侧或上方添加一个图标或图片。
- **android:drawablePadding**
- 用途：设置文本与图标之间的间距。
- 可以设置为负数以减小间距。
- **android:editable**
- 用途：设置文本是否可编辑。
- 注意事项：此属性在`EditText`组件中使用更为常见。
- **android:ellipsize**
- 用途：当文本过长无法完整显示时，定义文本的截断方式。
- 可选值：`start`（开头截断）、`end`（结尾截断）、`middle`（中间截断）、`marquee`（跑马灯效果）。
- **android:freezesText**
- 用途：设置是否保存文本内容及光标位置。
- **android:gravity**
- 用途：设置文本在视图内的对齐方式。
- 示例：`center`（居中显示）。
- **android:hint**
- 用途：设置当文本为空时显示的提示信息。
- 可配合`textColorHint`属性设置提示文本的颜色。
- **android:imeOptions**
- 用途：设置输入法的附加选项，如设置IME动作。
- 示例：`actionDone`（设置完成键）。
- **android:imeActionId/android:imeActionLabel**
- 用途：设置IME动作ID和标签。
- 在`EditText`组件中有更详细的说明。
- **android:includeFontPadding**
- 用途：设置文本上下方是否包含额外的空间。
- **android:inputMethod**
- 用途：为文本指定输入法。
- 需要完整的包名，如`com.google.android.inputmethod.pinyin`。
- **android:inputType**
- 用途：设置文本的类型，帮助输入法显示合适的键盘布局。
- 示例：`textEmailAddress`（电子邮件地址输入键盘）、`number`（数字键盘）等。
以上属性为TextView提供了一系列强大的功能，可以根据具体的应用场景灵活配置。了解这些属性的用途和限制有助于更好地利用TextView来提升用户体验。
