- java.lang.Object
-
- java.awt.Component
-
- java.awt.TextComponent
-
- 实现的所有接口
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
public class TextComponent extends Component implements Accessible
TextComponent
类是允许编辑某些文本的任何组件的超类。文本组件包含一串文本。
TextComponent
类定义了一组方法,用于确定此文本是否可编辑。 如果组件是可编辑的,则它定义了另一组支持文本插入插入符的方法。此外,该类定义了用于维护文本中当前选择的方法。 文本选择是组件文本的子字符串,是编辑操作的目标。 它也被称为选定的文本 。
- 从以下版本开始:
- 1.0
- 另请参见:
- Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
TextComponent.AccessibleAWTTextComponent
此类实现TextComponent
类的可访问性支持。
-
字段汇总
字段 变量和类型 字段 描述 protected TextListener
textListener
将从此对象接收事件的侦听器列表。-
声明的属性在类 java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
addNotify()
通过将此组件连接到本机屏幕资源,可以显示此组件。void
addTextListener(TextListener l)
添加指定的文本事件侦听器以从此文本组件接收文本事件。void
enableInputMethods(boolean enable)
启用或禁用此文本组件的输入法支持。AccessibleContext
getAccessibleContext()
获取与此TextComponent关联的AccessibleContext。Color
getBackground()
获取此文本组件的背景颜色。int
getCaretPosition()
返回文本插入插入符的位置。<T extends EventListener>
T[]getListeners(类<T> listenerType)
返回当前注册的所有对象的数组FooListener
在这个STextComponent
。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)
将此文本组件显示的文本设置为指定的文本。-
声明方法的类 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, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
-
-
-
字段详细信息
-
textListener
protected transient TextListener textListener
将从此对象接收事件的侦听器列表。
-
-
方法详细信息
-
enableInputMethods
public void enableInputMethods(boolean enable)
启用或禁用此文本组件的输入法支持。 如果启用了输入法支持,并且文本组件也处理键事件,则传入事件将提供给当前输入方法,并且只有组件处理或者如果输入方法不使用它们,则会将其分派给其侦听器。 默认情况下是否以及如何启用或禁用对此文本组件的输入方法支持取决于实现。- 重写:
-
enableInputMethods
在课程Component
- 参数
-
enable
- true表示启用,false表示禁用 - 从以下版本开始:
- 1.2
- 另请参见:
-
Component.processKeyEvent(java.awt.event.KeyEvent)
-
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
。 - 从以下版本开始:
- 1.0
- 另请参见:
-
setEditable(boolean)
-
setEditable
public void setEditable(boolean b)
设置用于确定此文本组件是否可编辑的标志。如果该标志设置为
true
,则此文本组件将成为用户可编辑的。 如果该标志设置为false
,则用户无法更改此文本组件的文本。 默认情况下,不可编辑的文本组件的背景颜色为SystemColor.control。 可以通过调用setBackground来覆盖此默认值。- 参数
-
b
- 一个标志,指示此文本组件是否可由用户编辑。 - 从以下版本开始:
- 1.0
- 另请参见:
-
isEditable()
-
getBackground
public Color getBackground()
获取此文本组件的背景颜色。 默认情况下,不可编辑的文本组件的背景颜色为SystemColor.control。 可以通过调用setBackground来覆盖此默认值。- 重写:
-
getBackground
在类Component
- 结果
- 此文本组件的背景颜色。 如果此文本组件没有背景颜色,则返回其父级的背景颜色。
- 从以下版本开始:
- 1.0
- 另请参见:
-
setBackground(Color)
-
setBackground
public void setBackground(Color c)
设置此文本组件的背景颜色。- 重写:
-
setBackground
在课程Component
- 参数
-
c
- 成为此文本组件颜色的颜色。 如果此参数为null,则此文本组件将继承其父项的背景颜色。 - 从以下版本开始:
- 1.0
- 另请参见:
-
getBackground()
-
getSelectionStart
public int getSelectionStart()
获取此文本组件中所选文本的起始位置。- 结果
- 所选文本的开始位置
- 另请参见:
-
setSelectionStart(int)
,getSelectionEnd()
-
setSelectionStart
public void setSelectionStart(int selectionStart)
将此文本组件的选择开始设置为指定位置。 新起点被限制在当前选择结束时或之前。 它也不能设置为小于零,即组件文本的开头。 如果调用者提供超出范围的selectionStart
的值,则该方法将以静默方式强制执行这些约束,并且不会出现故障。- 参数
-
selectionStart
- 所选文本的开始位置 - 从以下版本开始:
- 1.1
- 另请参见:
-
getSelectionStart()
,setSelectionEnd(int)
-
getSelectionEnd
public int getSelectionEnd()
获取此文本组件中所选文本的结束位置。- 结果
- 所选文本的结束位置
- 另请参见:
-
setSelectionEnd(int)
,getSelectionStart()
-
setSelectionEnd
public void setSelectionEnd(int selectionEnd)
将此文本组件的选择结束设置为指定位置。 新的终点被限制在当前选择开始时或之后。 它也不能超出组件文本的末尾。 如果调用者提供超出范围的selectionEnd
的值,则该方法将以静默方式强制执行这些约束,并且不会失败。- 参数
-
selectionEnd
- 所选文本的结束位置 - 从以下版本开始:
- 1.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
包含任何文本,TextComponent
0),并且不返回任何错误。 如果传入的值小于0,则抛出IllegalArgumentException
。- 参数
-
position
- 文本插入插入符的位置 - 异常
-
IllegalArgumentException
- 如果position
小于零 - 从以下版本开始:
- 1.1
-
getCaretPosition
public int getCaretPosition()
返回文本插入插入符的位置。 插入符号位置被限制在介于0和文本的最后一个字符之间(包括0和最后一个字符)。 如果尚未设置文本或插入符,则默认插入符号位置为0。- 结果
- 文本插入插入符号的位置
- 从以下版本开始:
- 1.1
- 另请参见:
-
setCaretPosition(int)
-
addTextListener
public void addTextListener(TextListener l)
- 参数
-
l
- 文本事件侦听器 - 另请参见:
-
removeTextListener(java.awt.event.TextListener)
,getTextListeners()
,TextListener
-
removeTextListener
public void removeTextListener(TextListener l)
删除指定的文本事件侦听器,以便它不再接收来自此文本组件的文本事件。如果l
是null
,则不会抛出异常并且不执行任何操作。有关AWT螺纹模型的详细信息,请参阅AWT Threading Issues 。
- 参数
-
l
- 文本侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
addTextListener(java.awt.event.TextListener)
,getTextListeners()
,TextListener
-
getTextListeners
public TextListener[] getTextListeners()
返回在此文本组件上注册的所有文本侦听器的数组。- 结果
-
所有这个文本组件的
TextListener
s或如果当前没有注册文本侦听器的空数组 - 从以下版本开始:
- 1.4
- 另请参见:
-
addTextListener(java.awt.event.TextListener)
,removeTextListener(java.awt.event.TextListener)
-
getListeners
public <T extends EventListener> T[] getListeners(类<T> listenerType)
返回当前注册的所有对象的数组FooListener
在这个STextComponent
。FooListener
s使用addFooListener
方法注册。您可以使用类文字指定
listenerType
参数,例如FooListener.class
。 例如,您可以使用以下代码查询TextComponent t
的文本侦听器:TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));
如果不存在此类侦听器,则此方法返回空数组。- 重写:
-
getListeners
在课程Component
- 参数类型
-
T
- 侦听器的类型 - 参数
-
listenerType
- 请求的侦听器类型; 此参数应指定从java.util.EventListener
下降的接口 - 结果
-
在此文本组件上注册为
FooListener
的所有对象的数组,如果未添加此类侦听器,则为空数组 - 异常
-
ClassCastException
- 如果listenerType
未指定实现java.util.EventListener
的类或接口 - 从以下版本开始:
- 1.3
- 另请参见:
-
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()
获取与此TextComponent关联的AccessibleContext。 对于文本组件,AccessibleContext采用AccessibleAWTTextComponent的形式。 如有必要,将创建一个新的AccessibleAWTTextComponent实例。- Specified by:
-
getAccessibleContext
在接口Accessible
- 重写:
-
getAccessibleContext
在课程Component
- 结果
- 一个AccessibleAWTTextComponent,用作此TextComponent的AccessibleContext
- 从以下版本开始:
- 1.3
-
-