路径: 使用Swing创建GUI
课程: 使用Swing组件
章节: 使用文本组件

文本组件API

此部分列出了文本组件共享的常用API部分。其中大部分API由JTextComponent类定义。关于如何使用此API的信息，请参阅文本组件功能。

JComponent类描述了文本组件从JComponent继承的API。有关特定文本组件相关的API，请参阅该组件的how-to页面：文本字段，密码字段，格式化文本字段，文本区域，或编辑器窗格和文本窗格。

有关文本API的完整详细信息，请参阅JTextComponent和文本包中的各个类和接口的API文档。

此部分列出的API包括以下类别：

**设置属性**
*这些方法在`JTextComponent`类中定义。*
方法	描述
void setEditable(boolean) boolean isEditable()	设置或指示用户是否可以编辑文本组件中的文本。
void setDragEnabled(boolean) boolean getDragEnabled()	设置或获取`dragEnabled`属性，该属性必须为true才能在此组件上启用拖放处理。默认值为false。有关更多详细信息，请参见拖放和数据传输。
void setDisabledTextColor(Color) Color getDisabledTextColor()	设置或获取文本组件禁用时用于显示文本的颜色。
void setMargin(Insets) Insets getMargin()	设置或获取文本和文本组件边框之间的边距。

操作选择
*这些方法在`JTextComponent`类中定义。*
方法	描述
String getSelectedText()	获取当前选择的文本。
void selectAll() void select(int, int)	选择所有文本或选择起始和结束范围内的文本。
void setSelectionStart(int) void setSelectionEnd(int) int getSelectionStart() int getSelectionEnd()	通过索引设置或获取当前选择的范围。
void setSelectedTextColor(Color) Color getSelectedTextColor()	设置或获取所选文本的颜色。
void setSelectionColor(Color) Color getSelectionColor()	设置或获取所选文本的背景颜色。

在模型和视图之间转换位置
*这些方法在`JTextComponent`类中定义。*
方法	描述
int viewToModel(Point)	将视图坐标系中的指定点转换为文本内的位置。
Rectangle modelToView(int)	将文本内的指定位置转换为视图坐标系中的矩形。

表示文档的类和接口
接口或类	描述
Document	定义所有文档必须实现的API的接口。
AbstractDocument	实现了`Document`接口的抽象超类。这是Swing文本包提供的所有文档的超类。
PlainDocument	实现了`Document`接口的类。这是纯文本组件（文本框、密码框和文本区域）的默认文档。此外，当加载纯文本或未知格式的文本时，编辑器窗格和文本窗格也使用此类。
StyledDocument	一个`Document`子接口。定义支持样式文本的文档必须实现的API。`JTextPane`要求其文档为此类型。
DefaultStyledDocument	实现了`StyledDocument`接口的类。是`JTextPane`的默认文档。

读写文本
方法	描述
void read(Reader, Object) void write(Writer) (在 `JTextComponent` 中)	读取或写入文本。
void read(Reader, Document, int) void read(InputStream, Document, int) (在 `EditorKit` 中)	从流中读取文本到文档中。
void write(Writer, Document, int, int) void write(OutputStream, Document, int, int) (在 `EditorKit` 中)	将文档中的文本写入流中。