类 java.awt.TextComponent

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.TextComponent

public class TextComponent

extends Component

下列类的父类：

TextArea, TextField

类 TextComponent 是所有的可编辑文本组件的父类。

一个文本组件表现一个文本串。类 TextComponent 定义了确定文本是否是可编辑的一个方法集。如果组件是可编辑的，那么它又定义了一个支持文本插入指示符的方法集。

另外，此类还定义了支持文本中的当前选定文本的方法。选定的文本，即组件中文本的子字符串，是编辑操作的对象。它也被当作已选择的文本引用。

变量索引

textListener

方法索引

addTextListener(TextListener)

添加指定文本事件的监听者，接收当前文本组件的文本事件。

getCaretPosition()

获取当前文本组件的文本插入符位置。

getSelectedText()

获取当前文本组件中出现的选定文本。

getSelectionEnd()

获取当前文本组件中的选定文本的结束位置。

getSelectionStart()

获取当前文本组件中的选定文本的开始位置。

getText()

获取当前文本组件表示的文本。

isEditable()

判定当前文本组件是否是可编辑的。

paramString()

返回表示当前文本组件状态的参数串。

processEvent(AWTEvent)

处理当前文本组件的事件。

processTextEvent(TextEvent)

处理发生在该组件上的文本事件，将其分配给任意一个已注册的 TextListener 对象。

removeNotify()

删除文本组件的同级件。

removeTextListener(TextListener)

删除指定的文本事件监听者，使其不再接收来自该组件的文本事件。

select(int, int)

选择指定的开始位和结束位间的文本。

selectAll()

选择当前文本组件中的所有文本。

setCaretPosition(int)

设置当前文本组件的文本插入符位置。

setEditable(boolean)

设置该标置，指示当前文本组件是否是可编辑的。

setSelectionEnd(int)

将当前文本组件的选择结束位置设置为指定值。

setSelectionStart(int)

将当前文本组件的选择开始位置设置为指定值。

setText(String)

将当前文本组件表示的文本设置为指定文本。

变量

 protected transient TextListener textListener

方法

 public void removeNotify()

删除文本组件的同级件。 该同级件允许在不改变文本组件功能的情况下改变其外观。

覆盖:

类 Component 中的 removeNotify

 public synchronized void setText(String t)

将当前文本组件表示的文本设置为指定文本。

参数：

t - 新文本。

参见：

getText

 public synchronized String getText()

获取当前文本组件表示的文本。

参见：

setText

 public synchronized String getSelectedText()

获取当前文本组件中出现的选定文本。

返回值：

当前文本组件中的选定文本。

参见：

select

 public boolean isEditable()

判定当前文本组件是否是可编辑的。

返回值：

如果当前文本组件是可编辑的则为 true；否则为 false。

参见：

setEditable

 public synchronized void setEditable(boolean b)

设置该标置，指示当前文本组件是否是可编辑的。

如果此标志设为 true, 那么当前文本组件是可编辑的。如果设为 false, 那么用户不能改变此组件。

参数：

t - 一个标志，指示当前文本组件是否可编辑。

参见：

isEditable

 public synchronized int getSelectionStart()

获取当前文本组件中的选定文本的开始位置。

返回值：

选定文本的开始位置。

参见：

setSelectionStart, getSelectionEnd

 public synchronized void setSelectionStart(int selectionStart)

将当前文本组件的选择开始位置设置为指定值。 新开始位置限于当前选择结束处或它之前。同时它不能小于组件文本的开始位(零)。如果调用者提供的 selectionStart 参数超出边界，那么此方法忽略以上这些限制，无失败信息。

参数：

selectionStart - 选定文本的开始位。

参见：

getSelectionStart, setSelectionEnd

 public synchronized int getSelectionEnd()

获取当前文本组件中的选定文本的结束位置。

返回值：

选定文本的结束位置。

参见：

setSelectionEnd, getSelectionStart

 public synchronized void setSelectionEnd(int selectionEnd)

将当前文本组件的选择结束位置设置为指定值。 新结束位置限于当前选择结束处或它之后。 同时它不能超过组件文本的结束位置。 如果调用者提供的 selectionEnd 参数超出边界，那么此方法忽略以上这些限制，无失败信息。

参数：

selectionEnd - 选定文本的结束位。

参见：

getSelectionEnd, setSelectionStart

 public synchronized void select(int selectionStart,
                                 int selectionEnd)

选择指定的开始位和结束位间的文本。

此方法设置选择文本的开始和结束位置，且规定结束位置必须大于或等于开始位置。开始位置必须大于零，结束位置必须小于或等于文本组件中文本的长度值。如果调用者提供的参数不满足这些限制或是超出边界，那么此方法将忽略这些限制，不产生失败信息。

参数：

selectionStart - 待选定的文本开始位。

selectionEnd - 待选定的文本结束位。

参见：

setSelectionStart, setSelectionEnd, selectAll

 public synchronized void selectAll()

选择当前文本组件中的所有文本。

参见：

TextComponent@select

 public synchronized void setCaretPosition(int position)

设置当前文本组件的文本插入符位置。

参数：

position - 文本插入符位置。

抛出： IllegalArgumentException

如果给定的 position 值小于零。

 public synchronized int getCaretPosition()

获取当前文本组件的文本插入符位置。

返回值：

文本插入符的位置。

 public synchronized void addTextListener(TextListener l)

添加指定文本事件的监听者，接收当前文本组件的文本事件。

参数：

l - 文本事件监听者

 public void removeTextListener(TextListener l)

删除指定的文本事件监听者，使其不再接收来自该组件的文本事件。

 protected void processEvent(AWTEvent e)

处理当前文本组件的事件。 若事件是 TextEvent，则调用 processTextEvent 方法，否则调用其父类的 processEvent 方法。

参数：

e - 事件

覆盖：

processEvent 类 Component 中的

 protected void processTextEvent(TextEvent e)

处理发生在该组件上的文本事件，将其分配给任意一个已注册的 TextListener 对象。 注意：除非该组件的文本事件有效，否则将不能调用该方法；当下列一个情况发生时它被调用： a) 通过 addTextListener() 方法注册了一个 TextListener 对象。 b) 通过 enableEvents() 方法使文本事件有效。

参数：

e - 文本事件

参见：

enableEvents

 protected String paramString()

返回表示当前文本组件状态的参数串。 该字符串对调试有用。

返回值：

表示当前文本组件的参数串。

覆盖：

> 类 Component 中的 paramString