TextComponent (Java Platform SE 8 )

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

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible

已知直接子类：

TextArea， TextField
```
public class TextComponent
extends Component
implements Accessible
```
TextComponent类的任何组件，允许一些文本编辑类。
一个文本组件包含一个文本字符串。的TextComponent类定义了一组方法，确定这是否是可编辑的文本。如果组件是可编辑的，它定义了一组方法，支持文本插入符号。

此外，类定义了用于从文本保持当前选择的方法。文本的选择、子组件的文字，是编辑操作的目标。它也被称为选定的文本。

从以下版本开始：

JDK1.0

另请参见：

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`TextComponent.AccessibleAWTTextComponent` 这个类实现了对 `TextComponent`类可访问性支持。

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`protected TextListener`	`textListener`

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addNotify()` 使该组件可通过连接到一个本地网资源。
`void`	`addTextListener(TextListener l)` 添加指定的文本事件侦听器，以从该文本组件接收文本事件。
`void`	`enableInputMethods(boolean enable)` 启用或禁用此文本组件的输入方法支持。
`AccessibleContext`	`getAccessibleContext()` 获取与此相关的accessiblecontext textcomponent。
`Color`	`getBackground()` 获取此文本组件的背景颜色。
`int`	`getCaretPosition()` 返回文本插入符号的位置。
`InputMethodRequests`	`getInputMethodRequests()` 获取支持此组件的输入方法的输入法请求处理程序。
`<T extends EventListener> T[]`	`getListeners(类<T> listenerType)` 返回对象的当前注册为 `FooListener`s在这 `TextComponent`数组。
`String`	`getSelectedText()` 返回由该文本组件呈现的文本的选定文本。
`int`	`getSelectionEnd()` 获取在该文本组件中选定的文本的结束位置。
`int`	`getSelectionStart()` 获取在该文本组件中选定的文本的起始位置。
`String`	`getText()` 返回由该文本组件提交的文本。
`TextListener[]`	`getTextListeners()` 返回在该文本组件上注册的所有文本侦听器的数组。
`boolean`	`isEditable()` 指示是否这个组件是可编辑的文本。
`protected String`	`paramString()` 返回一个字符串，表示此 `TextComponent`状态。
`protected void`	`processEvent(AWTEvent e)` 处理此文本组件的事件。
`protected void`	`processTextEvent(TextEvent e)` 事件发生在这个过程的文本的文本组件调度到任何注册 `TextListener`对象。
`void`	`removeNotify()` 删除 `TextComponent`的同伴。
`void`	`removeTextListener(TextListener l)` 移除指定的文本事件监听器，它不再接收文本事件从这个文本组件如果 `l`是 `null`，不引发异常，则不执行行动。
`void`	`select(int selectionStart, int selectionEnd)` 选择指定的开始和结束位置之间的文本。
`void`	`selectAll()` 选择此文本组件中的所有文本。
`void`	`setBackground(Color c)` 设置此文本组件的背景颜色。
`void`	`setCaretPosition(int position)` 设置文本插入符号的位置。
`void`	`setEditable(boolean b)` 设置决定这是否是可编辑的文本组件。
`void`	`setSelectionEnd(int selectionEnd)` 将此文本组件的选择端设置为指定位置。
`void`	`setSelectionStart(int selectionStart)` 将此文本组件的选择开始设置为指定的位置。
`void`	`setText(String t)` 将由该文本组件呈现的文本设置为指定的文本。

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - textListener
```
protected transient TextListener textListener
```
- 方法详细信息
  - enableInputMethods
```
public void enableInputMethods(boolean enable)
```
    启用或禁用此文本组件的输入方法支持。如果启用了输入法支持，文本组件也处理关键事件，传入的事件提供给当前的输入方法，将只处理的组件或发送给它的听众，如果输入方法不消耗他们。是否和如何默认启用此文本组件的输入方法支持是依赖于实现的。
    
    重写：
    
    enableInputMethods 方法重写，继承类 Component
    
    参数
    
    enable真使，假禁用
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Component.processKeyEvent(java.awt.event.KeyEvent)
  - getInputMethodRequests
```
public InputMethodRequests getInputMethodRequests()
```
    从阶级复制的描述： Component
    
    获取支持此组件的输入方法的输入法请求处理程序。一个支持现场文本输入组件必须重写此方法以返回一个 InputMethodRequests实例。在同一时间，它也有处理输入法事件。
    
    重写：
    
    getInputMethodRequests 方法重写，继承类 Component
    
    结果
    
    输入法的请求处理程序这一部分， null默认
    
    另请参见：
    
    Component.addInputMethodListener(java.awt.event.InputMethodListener)
  - addNotify
```
public void addNotify()
```
    使该组件可通过连接到一个本地网资源。这种方法被称为内部的工具包，不应该直接调用程序。
    
    重写：
    
    addNotify 方法重写，继承类 Component
    
    另请参见：
    
    removeNotify()
  - removeNotify
```
public void removeNotify()
```
    删除 TextComponent的同伴。同伴让我们修改的 TextComponent外观没有改变其功能。
    
    重写：
    
    removeNotify 方法重写，继承类 Component
    
    另请参见：
    
    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重写默认。
    
    重写：
    
    getBackground 方法重写，继承类 Component
    
    结果
    
    此文本组件的背景颜色。如果此文本组件没有背景色，则返回其父的背景颜色。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    setBackground(Color)
  - setBackground
```
public void setBackground(Color c)
```
    设置此文本组件的背景颜色。
    
    重写：
    
    setBackground 方法重写，继承类 Component
    
    参数
    
    c的色彩成为这个文本组件的颜色。如果这个参数是空的，那么这个文本组件将继承它的父的背景颜色。
    
    从以下版本开始：
    
    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 -零基础的结束位置的文本被选中；字符（ char值）在 selectionEnd没有选择
    
    另请参见：
    
    setSelectionStart(int)， setSelectionEnd(int)， selectAll()
  - selectAll
```
public void selectAll()
```
    选择此文本组件中的所有文本。
    
    另请参见：
    
    select(int, int)
  - setCaretPosition
```
public void setCaretPosition(int position)
```
    设置文本插入符号的位置。插入符号的位置被限制为0和正文的最后一个字符之间，包容。如果传入的值大于此范围的值设置为最后一个字符（或0如果 TextComponent不包含文本）和不返回错误。如果传入的值小于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 Threading Issues对AWT的线程模型的细节。
    
    参数
    
    l -文本事件监听器
    
    另请参见：
    
    removeTextListener(java.awt.event.TextListener)， getTextListeners()， TextListener
  - removeTextListener
```
public void removeTextListener(TextListener l)
```
    移除指定的文本事件监听器，它不再接收文本事件从这个文本组件如果 l是 null，不引发异常，则不执行行动。
    参考AWT Threading Issues对AWT的线程模型的细节。
    
    参数
    
    l -文本的倾听者
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    addTextListener(java.awt.event.TextListener)， getTextListeners()， TextListener
  - getTextListeners
```
public TextListener[] getTextListeners()
```
    返回在该文本组件上注册的所有文本侦听器的数组。
    
    结果
    
    所有这些文本组件的 TextListeners或空数组如果没有文字的听众正在注册
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    addTextListener(java.awt.event.TextListener)， removeTextListener(java.awt.event.TextListener)
  - getListeners
```
public <T extends EventListener> T[] getListeners(类<T> listenerType)
```
    返回对象的当前注册为 FooListeners在这 TextComponent数组。 FooListeners使用 addFooListener方法注册。如果没有这样
    您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其文本的听众与下面的代码TextComponent t：
```
textlistener [] TLS =（textlistener [ ]）（t.getlisteners（textlistener。类））；
```
    听众的存在，此方法将返回空数组。
    重写：
    
    getListeners 方法重写，继承类 Component
    
    参数
    
    listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener
    
    结果
    
    所有注册的对象作为这个文本组件 FooListeners数组，或一个空数组如果没有这样的听众已添加
    
    异常
    
    ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    getTextListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    处理此文本组件的事件。如果事件是 TextEvent，它调用 processTextEvent方法调用它的父类的 processEvent。
    注意，如果参数是null行为是不可能导致异常。
    
    重写：
    
    processEvent 方法重写，继承类 Component
    
    参数
    
    e -事件
    
    另请参见：
    
    Component.processComponentEvent(java.awt.event.ComponentEvent)， Component.processFocusEvent(java.awt.event.FocusEvent)， Component.processKeyEvent(java.awt.event.KeyEvent)， Component.processMouseEvent(java.awt.event.MouseEvent)， Component.processMouseMotionEvent(java.awt.event.MouseEvent)， Component.processInputMethodEvent(java.awt.event.InputMethodEvent)， Component.processHierarchyEvent(java.awt.event.HierarchyEvent)， Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)
  - processTextEvent
```
protected void processTextEvent(TextEvent e)
```
    事件发生在这个过程的文本的文本组件调度到任何注册 TextListener对象。
    注：除非此组件启用了文本事件，否则无法调用此方法。这种情况发生时，发生下列情况之一：
    - 一个TextListener对象是通过addTextListener注册
    - 文本事件能够通过enableEvents
    注意，如果参数是null行为是不可能导致异常。
    参数
    
    e文本-事件
    
    另请参见：
    
    Component.enableEvents(long)
  - paramString
```
protected String paramString()
```
    返回一个字符串，表示此 TextComponent状态。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。
    
    重写：
    
    paramString 方法重写，继承类 Component
    
    结果
    
    此文本组件的参数字符串
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此相关的accessiblecontext textcomponent。文本组件，该accessiblecontext以一个accessibleawttextcomponent形式。一个新的accessibleawttextcomponent实例被创建时。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 Component
    
    结果
    
    一个accessibleawttextcomponent作为本textcomponent的accessiblecontext
    
    从以下版本开始：
    
    一点三

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class TextComponent

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

方法摘要

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

textListener

方法详细信息

enableInputMethods

getInputMethodRequests

addNotify

removeNotify

setText

getText

getSelectedText

isEditable

setEditable

getBackground

setBackground

getSelectionStart

setSelectionStart

getSelectionEnd

setSelectionEnd

select

selectAll

setCaretPosition

getCaretPosition

addTextListener

removeTextListener

getTextListeners

getListeners

processEvent

processTextEvent

paramString

getAccessibleContext