java.awt
类 TextComponent

java.lang.Object
  java.awt.Component
      java.awt.TextComponent

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

直接已知子类：

TextArea, TextField

public class TextComponent
     

      extends 
      Component
     
     

      implements 
      Accessible
     

TextComponent 类是所有允许编辑文本的组件的超类。

文本组件具体化文本字符串。TextComponent 类定义了一组判断此文本是否可编辑的方法。如果组件是可编辑的，则该类还定义了另一组支持文件插入符的方法。

此外，该类定义了用于维护文本当前选择 的方法。文本选择是组件文本的子字符串，是编辑操作的目标。它也被称为选定文本。

从以下版本开始：

JDK1.0

另请参见：

序列化表格

textListener

protected transient TextListener textListener

enableInputMethods

public void enableInputMethods(boolean enable)

启用或禁用此文本组件的输入法支持。如果启用输入法支持并且文本组件也能处理按键事件，则将传入事件提供给当前输入法；如果输入法没有使用它们，则它们只能由组件处理或被指派给它们的侦听器。默认情况下，启用还是禁用，以及如何启用或禁用此文本组建的输入法支持与实现有关。

覆盖：

类 Component 中的 enableInputMethods

参数：

enable - 为 true 表示启用；为 false 表示禁用

从以下版本开始：

1.2

另请参见：

Component.processKeyEvent(java.awt.event.KeyEvent)

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

从类 Component 复制的描述

获取输入方法请求处理程序，该处理程序支持此组件输入方法发出的请求。支持当场文本输入的组件必须重写此方法，以便返回一个 InputMethodRequests 实例。同时，还必须处理输入方法事件。

覆盖：

类 Component 中的 getInputMethodRequests

返回：

组件的输入方法请求处理程序，默认为 null

另请参见：

Component.addInputMethodListener(java.awt.event.InputMethodListener)

addNotify

public void addNotify()

通过将此 Component 连接到一个本机屏幕资源，使其成为可显示的。此方法由工具包内部调用，不应直接由程序调用。

覆盖：

类 Component 中的 addNotify

另请参见：

removeNotify()

removeNotify

public void removeNotify()

移除 TextComponent 的同位体。该同位体允许我们修改 TextComponent 的外观，而不更改其功能。

覆盖：

类 Component 中的 removeNotify

另请参见：

Component.isDisplayable(), Component.addNotify()

setText

public void setText(String t)

将此文本组件显示的文本设置为指定文本。

参数：

t - 新文本；如果此参数为 null，则将文本设置为空字符串 ""

另请参见：

getText()

getText

public String getText()

返回此文本组件表示的文本。默认情况下，此文本是一个空字符串。

返回：

此 TextComponent 的值

另请参见：

setText(java.lang.String)

getSelectedText

public String getSelectedText()

返回此文本组件所表示文本的选定文本。

返回：

此文本组件的选定文本

另请参见：

select(int, int)

isEditable

public boolean isEditable()

指示此文本组件是否可编辑。

返回：

如果此文本组件是可编辑的，则返回 true；否则返回 false。

从以下版本开始：

JDK1.0

另请参见：

setEditable(boolean)

setEditable

public void setEditable(boolean b)

设置判断此文本组件是否可编辑的标志。

如果将该标志设置为 true，则此文本组件变成用户可编辑的。如果将该标志设置为 false，则用户无法更改此文本组件的文本。默认情况下，不可编辑的文本组件的背景色为 SystemColor.control。通过调用 setBackground 可以重写此默认值。

参数：

b - 指示此文本组件是否是用户可编辑的标志。

从以下版本开始：

JDK1.0

另请参见：

isEditable()

getBackground

public Color getBackground()

获得此文本组件的背景色。默认情况下，不可编辑的文本组件的背景色为 SystemColor.control。通过调用 setBackground 可以重写此默认值。

覆盖：

类 Component 中的 getBackground

返回：

此文本组件的背景色。如果此文本组件没有背景色，则返回其父组件的背景色。

从以下版本开始：

JDK1.0

另请参见：

setBackground(Color)

setBackground

public void setBackground(Color c)

设置此文本组件的背景色。

覆盖：

类 Component 中的 setBackground

参数：

c - 成为此文本组件颜色的颜色。如果此参数为 null，则此文本组件将继承其父组件的背景色。

从以下版本开始：

JDK1.0

另请参见：

getBackground()

getSelectionStart

public int getSelectionStart()

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

返回：

选定文本的开始位置

另请参见：

setSelectionStart(int), getSelectionEnd()

setSelectionStart

public void setSelectionStart(int selectionStart)

将此文本组件的选定开始位置设置为指定位置。新的起始点限制在当前选定结束位置处或之前。并且不能将它设置为小于零，即小于组件文本的开始处。如果调用者提供的 selectionStart 值超出限度，则该方法暗中执行这些限制，操作不会失败。

参数：

selectionStart - 选定文本的开始位置

从以下版本开始：

JDK1.1

另请参见：

getSelectionStart(), setSelectionEnd(int)

getSelectionEnd

public int getSelectionEnd()

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

返回：

选定文本的结束位置

另请参见：

setSelectionEnd(int), getSelectionStart()

setSelectionEnd

public void setSelectionEnd(int selectionEnd)

将此文本组件的选定结束位置设置为指定位置。新的结束点限制在当前选定开始位置处或之后。并且不能将它设置为超出组件文本末端。如果调用者提供的 selectionEnd 值超出限度，则该方法暗中执行这些限制，操作不会失败。

参数：

selectionEnd - 选定文本的结束位置

从以下版本开始：

JDK1.1

另请参见：

getSelectionEnd(), setSelectionStart(int)

select

public void select(int selectionStart,
                   int selectionEnd)

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

此方法设置选定文本的开始位置和结束位置，并强行限制开始位置必须大于等于零。结束位置必须大于等于开始位置，并小于等于文本组件的文本长度。字符位置的索引从零开始。选择文本的长度是 endPosition - startPosition，因此没有选定 endPosition 处的字符。如果选定文本的开始位置和结束位置是相等的，则取消对所有文本的选择。

如果调用者提供不一致或超出限度的值，则该方法暗中执行这些限制，操作不会失败。具体来说，如果开始位置或结束位置大于文本长度，则将它重置为等于文本长度。如果开始位置小于零，则将它重置为零，如果结束位置小于开始位置，则将它重置为开始位置。

参数：

selectionStart - 要选定的首字符（ char 值）从零开始的索引

selectionEnd - 要选定的文本从零开始的结束位置； selectionEnd 处的字符（ char 值）未被选定

另请参见：

setSelectionStart(int), setSelectionEnd(int), selectAll()

selectAll

public void selectAll()

选择此文本组件中的所有文本。

另请参见：

select(int, int)

setCaretPosition

public void setCaretPosition(int position)

设置文本插入符的位置。插入符的位置被限制在 0 和文本最后一个字符（包括）之间。如果传入值大于此范围，则将该值设置为最后一个字符（如果 TextComponent 不包含文本，则将该值设置为 0），并且不返回任何错误。如果传入值小于 0，则抛出 IllegalArgumentException。

参数：

position - 文本插入符的位置

抛出：

IllegalArgumentException - 如果 position 小于零

从以下版本开始：

JDK1.1

getCaretPosition

public int getCaretPosition()

返回文本插入符的位置。插入符的位置被限制在 0 和文本最后一个字符（包括）之间。如果没有设置文本或插入符，则默认插入符的位置为 0。

返回：

文本插入符的位置

从以下版本开始：

JDK1.1

另请参见：

setCaretPosition(int)

addTextListener

public void addTextListener(TextListener l)

添加指定的文本事件侦听器，以接收此文本组件发出的文本事件。如果 l 为 null，则不抛出任何异常，也不执行任何操作。

有关 AWT 线程模式的详细信息，请参考 AWT Threading Issues。

参数：

l - 文本事件侦听器

另请参见：

removeTextListener(java.awt.event.TextListener), getTextListeners(), TextListener

removeTextListener

public void removeTextListener(TextListener l)

移除指定的文本事件侦听器，不再接收此文本组件发出的文本事件。如果 l 为 null，则不抛出任何异常，也不执行任何操作。

有关 AWT 线程模式的详细信息，请参考 AWT Threading Issues。

参数：

l - 文本侦听器

从以下版本开始：

JDK1.1

另请参见：

addTextListener(java.awt.event.TextListener), getTextListeners(), TextListener

getTextListeners

public TextListener[] getTextListeners()

返回在此文本组件上所有已注册文本侦听器的数组。

返回：

此文本组件的所有 TextListener；如果当前没有已注册的文本侦听器，则返回一个空数组

从以下版本开始：

1.4

另请参见：

addTextListener(java.awt.event.TextListener), removeTextListener(java.awt.event.TextListener)

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回当前已在此 TextComponent 上注册为 FooListener 的所有对象的数组。 FooListener 是用 addFooListener 方法注册的。

可以使用 class 字