©
This document uses PHP Chinese website manual Release
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.TextComponent
public class TextComponent
TextComponent
类是所有允许编辑文本的组件的超类。
文本组件具体化文本字符串。TextComponent
类定义了一组判断此文本是否可编辑的方法。如果组件是可编辑的,则该类还定义了另一组支持文件插入符的方法。
此外,该类定义了用于维护文本当前选择 的方法。文本选择是组件文本的子字符串,是编辑操作的目标。它也被称为选定文本。
嵌套类摘要 | |
---|---|
protected class |
TextComponent.AccessibleAWTTextComponent
此类实现对 TextComponent 类的可访问性支持。 |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
protected TextListener |
textListener
|
从类 java.awt.Component 继承的字段 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
从接口 java.awt.image.ImageObserver 继承的字段 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
方法摘要 | ||
---|---|---|
void |
addNotify()
通过将此 Component 连接到一个本机屏幕资源,使其成为可显示的。 |
|
void |
addTextListener(TextListener l)
添加指定的文本事件侦听器,以接收此文本组件发出的文本事件。 |
|
void |
enableInputMethods(boolean enable)
启用或禁用此文本组件的输入法支持。 |
|
AccessibleContext |
getAccessibleContext()
获取与此 TextComponent 关联的 AccessibleContext。 |
|
Color |
getBackground()
获得此文本组件的背景色。 |
|
int |
getCaretPosition()
返回文本插入符的位置。 |
|
InputMethodRequests |
getInputMethodRequests()
获取输入方法请求处理程序,该处理程序支持此组件输入方法发出的请求。 |
|
|
getListeners(Class<T> listenerType)
返回当前已在此 TextComponent 上注册为 FooListener 的所有对象的数组。 |
|
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)
移除指定的文本事件侦听器,不再接收此文本组件发出的文本事件。 |
|
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, 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, 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 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
protected transient TextListener textListener
方法详细信息 |
---|
public void enableInputMethods(boolean enable)
Component
中的 enableInputMethods
enable
- 为 true 表示启用;为 false 表示禁用Component.processKeyEvent(java.awt.event.KeyEvent)
public InputMethodRequests getInputMethodRequests()
Component
复制的描述InputMethodRequests
实例。同时,还必须处理输入方法事件。
Component
中的 getInputMethodRequests
null
Component.addInputMethodListener(java.awt.event.InputMethodListener)
public void addNotify()
Component
中的 addNotify
removeNotify()
public void removeNotify()
TextComponent
的同位体。该同位体允许我们修改 TextComponent
的外观,而不更改其功能。
Component
中的 removeNotify
Component.isDisplayable()
,
Component.addNotify()
public void setText(String t)
t
- 新文本;如果此参数为 null
,则将文本设置为空字符串 ""getText()
public String getText()
TextComponent
的值setText(java.lang.String)
public String getSelectedText()
select(int, int)
public boolean isEditable()
true
;否则返回 false
。setEditable(boolean)
public void setEditable(boolean b)
如果将该标志设置为 true
,则此文本组件变成用户可编辑的。如果将该标志设置为 false
,则用户无法更改此文本组件的文本。默认情况下,不可编辑的文本组件的背景色为 SystemColor.control。通过调用 setBackground 可以重写此默认值。
b
- 指示此文本组件是否是用户可编辑的标志。isEditable()
public Color getBackground()
Component
中的 getBackground
setBackground(Color)
public void setBackground(Color c)
Component
中的 setBackground
c
- 成为此文本组件颜色的颜色。如果此参数为 null,则此文本组件将继承其父组件的背景色。getBackground()
public int getSelectionStart()
setSelectionStart(int)
,
getSelectionEnd()
public void setSelectionStart(int selectionStart)
selectionStart
值超出限度,则该方法暗中执行这些限制,操作不会失败。
selectionStart
- 选定文本的开始位置getSelectionStart()
,
setSelectionEnd(int)
public int getSelectionEnd()
setSelectionEnd(int)
,
getSelectionStart()
public void setSelectionEnd(int selectionEnd)
selectionEnd
值超出限度,则该方法暗中执行这些限制,操作不会失败。
selectionEnd
- 选定文本的结束位置getSelectionEnd()
,
setSelectionStart(int)
public void select(int selectionStart, int selectionEnd)
此方法设置选定文本的开始位置和结束位置,并强行限制开始位置必须大于等于零。结束位置必须大于等于开始位置,并小于等于文本组件的文本长度。字符位置的索引从零开始。选择文本的长度是 endPosition
- startPosition
,因此没有选定 endPosition
处的字符。如果选定文本的开始位置和结束位置是相等的,则取消对所有文本的选择。
如果调用者提供不一致或超出限度的值,则该方法暗中执行这些限制,操作不会失败。具体来说,如果开始位置或结束位置大于文本长度,则将它重置为等于文本长度。如果开始位置小于零,则将它重置为零,如果结束位置小于开始位置,则将它重置为开始位置。
selectionStart
- 要选定的首字符(char
值)从零开始的索引selectionEnd
- 要选定的文本从零开始的结束位置;selectionEnd
处的字符(char
值)未被选定setSelectionStart(int)
,
setSelectionEnd(int)
,
selectAll()
public void selectAll()
select(int, int)
public void setCaretPosition(int position)
TextComponent
不包含文本,则将该值设置为 0),并且不返回任何错误。如果传入值小于 0,则抛出 IllegalArgumentException
。
position
- 文本插入符的位置
IllegalArgumentException
- 如果 position
小于零public int getCaretPosition()
setCaretPosition(int)
public void addTextListener(TextListener l)
l
为 null
,则不抛出任何异常,也不执行任何操作。
有关 AWT 线程模式的详细信息,请参考 AWT Threading Issues。
l
- 文本事件侦听器removeTextListener(java.awt.event.TextListener)
,
getTextListeners()
,
TextListener
public void removeTextListener(TextListener l)
l
为 null
,则不抛出任何异常,也不执行任何操作。
有关 AWT 线程模式的详细信息,请参考 AWT Threading Issues。
l
- 文本侦听器addTextListener(java.awt.event.TextListener)
,
getTextListeners()
,
TextListener
public TextListener[] getTextListeners()
TextListener
;如果当前没有已注册的文本侦听器,则返回一个空数组addTextListener(java.awt.event.TextListener)
,
removeTextListener(java.awt.event.TextListener)
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
TextComponent
上注册为 FooListener
的所有对象的数组。FooListener
是用 addFooListener
方法注册的。
可以使用 class 字面值来指定 listenerType
参数,如 FooListener.class
。例如,可以使用以下代码来查询 TextComponent
t
的文本侦听器:
TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));如果不存在这样的侦听器,则此方法返回一个空数组。
Component
中的 getListeners
listenerType
- 请求的侦听器类型;此参数应该指定一个从 java.util.EventListener
继承的接口
FooListener
注册的所有对象的数组;如果尚未添加这样的侦听器,则返回一个空数组
ClassCastException
- 如果 listenerType
未指定一个实现 java.util.EventListener
的类或接口getTextListeners()
protected void processEvent(AWTEvent e)
TextEvent
,那么它将调用 processTextEvent
方法,否则它将调用其超类的 processEvent
。
注意,如果事件参数为 null
,则行为是不明确的,并可能导致异常。
Component
中的 processEvent
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)
protected void processTextEvent(TextEvent e)
TextListener
对象。
注:如果没有对此组件启用文本事件,则不调用此方法。这发生在出现以下情况之一时:
addTextListener
注册一个 TextListener
对象。
enableEvents
启用文本事件
注意,如果事件参数为 null
,则行为是不明确的,并可能导致异常。
e
- 文本事件Component.enableEvents(long)
protected String paramString()
TextComponent
状态的字符串。此方法仅用于调试目的,对于各个实现,返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null
。
Component
中的 paramString
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
Component
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。