- java.lang.Object
-
- java.awt.Component
-
- java.awt.TextComponent
-
- java.awt.TextField
-
- 实现的所有接口
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
public class TextFieldextends TextComponent
TextField
对象是一个文本组件,允许编辑单行文本。例如,下图描绘了具有四个不同宽度的文本字段的帧。 其中两个文本字段显示预定义文本
"Hello"
。以下是生成这四个文本字段的代码:
TextField tf1, tf2, tf3, tf4; // a blank text field tf1 = new TextField(); // blank field of 20 columns tf2 = new TextField("", 20); // predefined text displayed tf3 = new TextField("Hello!"); // predefined text in 30 columns tf4 = new TextField("Hello", 30);
每次用户在文本字段中键入键时,都会将一个或多个键事件发送到文本字段。 A
KeyEvent
可以是以下三种类型之一:keyPressed,keyReleased或keyTyped。 键事件的属性指示它们是哪种类型,以及有关事件的其他信息,例如应用于键事件的修饰符和事件发生的时间。键事件将传递给每个
KeyListener
或KeyAdapter
对象,该对象使用组件的addKeyListener
方法注册接收此类事件。 (KeyAdapter
对象实现了KeyListener
接口。)也可以发射
ActionEvent
。 如果为文本字段启用了操作事件,则可以通过按Return
键来触发它们。TextField
类的processEvent
方法检查操作事件并将其传递给processActionEvent
。 后一种方法将事件重定向到已注册接收此文本字段生成的操作事件的任何ActionListener
对象。
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
TextField.AccessibleAWTTextField
此类实现TextField
类的可访问性支持。-
嵌套类/接口声明在类 java.awt.TextComponent
TextComponent.AccessibleAWTTextComponent
-
-
字段汇总
-
声明的属性在类 java.awt.TextComponent
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
addActionListener(ActionListener l)
添加指定的操作侦听器以从此文本字段接收操作事件。void
addNotify()
创建TextField的对等方。boolean
echoCharIsSet()
指示此文本字段是否具有用于回显的字符集。AccessibleContext
getAccessibleContext()
获取与此TextField关联的AccessibleContext。ActionListener[]
getActionListeners()
返回在此文本字段上注册的所有动作侦听器的数组。int
getColumns()
获取此文本字段中的列数。char
getEchoChar()
获取要用于回显的字符。<T extends EventListener>
T[]getListeners(类<T> listenerType)
返回当前注册的所有对象的数组FooListener
在这个STextField
。Dimension
getMinimumSize()
获取此文本字段的最小尺寸。Dimension
getMinimumSize(int columns)
获取具有指定列数的文本字段的最小尺寸。Dimension
getPreferredSize()
获取此文本字段的首选大小。Dimension
getPreferredSize(int columns)
获取具有指定列数的此文本字段的首选大小。Dimension
minimumSize()
已过时。截至JDK 1.1版,由getMinimumSize()
取代。Dimension
minimumSize(int columns)
已过时。截至JDK 1.1版,由getMinimumSize(int)
取代。protected String
paramString()
返回表示此TextField
的状态的字符串。Dimension
preferredSize()
已过时。截至JDK 1.1版,由getPreferredSize()
取代。Dimension
preferredSize(int columns)
已过时。截至JDK 1.1版,由getPreferredSize(int)
取代。protected void
processActionEvent(ActionEvent e)
处理在此文本字段上发生的操作事件,方法是将它们分派给任何已注册的ActionListener
对象。protected void
processEvent(AWTEvent e)
处理此文本字段上的事件。void
removeActionListener(ActionListener l)
删除指定的操作侦听器,以便它不再从此文本字段接收操作事件。void
setColumns(int columns)
设置此文本字段中的列数。void
setEchoChar(char c)
设置此文本字段的回显字符。void
setEchoCharacter(char c)
已过时。截至JDK 1.1版,由setEchoChar(char)
取代。void
setText(String t)
将此文本组件显示的文本设置为指定的文本。-
声明方法的类 java.awt.TextComponent
addTextListener, enableInputMethods, getBackground, getCaretPosition, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart
-
声明方法的类 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, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, 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
-
-
-
-
构造方法详细信息
-
TextField
public TextField() throws HeadlessException
构造一个新的文本字段。- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
TextField
public TextField(String text) throws HeadlessException
构造使用指定文本初始化的新文本字段。- 参数
-
text
- 要显示的文本。 如果text
是null
,将显示空字符串""
。 如果text
包含EOL和/或LF字符,则每个字符都将替换为空格字符。 - 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
TextField
public TextField(int columns) throws HeadlessException
构造具有指定列数的新空文本字段。 列是与平台相关的近似平均字符宽度。- 参数
-
columns
- 列数。 如果columns
小于0
,columns
设置为0
。 - 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
TextField
public TextField(String text, int columns) throws HeadlessException
构造一个使用要显示的指定文本初始化的新文本字段,并且宽度足以容纳指定数量的列。 列是与平台相关的近似平均字符宽度。- 参数
-
text
- 要显示的文本。 如果text
是null
,将显示空字符串""
。 如果text
包含EOL和/或LF字符,则每个字符都将替换为空格字符。 -
columns
- 列数。 如果columns
小于0
,则columns
设置为0
。 - 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
-
方法详细信息
-
addNotify
public void addNotify()
创建TextField的对等方。 对等体允许我们在不改变其功能的情况下修改TextField的外观。- 重写:
-
addNotify
在类TextComponent
- 另请参见:
-
TextComponent.removeNotify()
-
getEchoChar
public char getEchoChar()
获取要用于回显的字符。回显字符对于不应将用户输入回显到屏幕的文本字段很有用,例如输入密码的文本字段。 如果
echoChar
=0
,则用户输入将不变地回显到屏幕。Java平台实现可能仅支持有限的非空回声字符集。 此函数返回最初通过setEchoChar()请求的echo字符。 TextField实现实际使用的echo字符可能不同。
- 结果
- 此文本字段的回显字符。
- 另请参见:
-
echoCharIsSet()
,setEchoChar(char)
-
setEchoChar
public void setEchoChar(char c)
设置此文本字段的回显字符。回显字符对于不应将用户输入回显到屏幕的文本字段很有用,例如输入密码的文本字段。 设置
echoChar
=0
允许用户输入再次回显到屏幕。Java平台实现可能仅支持有限的非空回声字符集。 尝试设置不受支持的回显字符将导致使用默认回显字符。 对getEchoChar()的后续调用将返回最初请求的echo字符。 这可能与TextField实现实际使用的echo字符相同,也可能不同。
- 参数
-
c
- 此文本字段的回显字符。 - 从以下版本开始:
- 1.1
- 另请参见:
-
echoCharIsSet()
,getEchoChar()
-
setEchoCharacter
@Deprecatedpublic void setEchoCharacter(char c)
Deprecated.As of JDK version 1.1, replaced bysetEchoChar(char)
.设置显示受保护输入时要回显的字符。- 参数
-
c
- 此文本字段的回显字符
-
setText
public void setText(String t)
将此文本组件显示的文本设置为指定的文本。- 重写:
-
setText
在类TextComponent
- 参数
-
t
- 新文本。 如果t
是null
,将显示空字符串""
。 如果t
包含EOL和/或LF字符,则每个字符将替换为空格字符。 - 另请参见:
-
TextComponent.getText()
-
echoCharIsSet
public boolean echoCharIsSet()
指示此文本字段是否具有用于回显的字符集。回显字符对于不应将用户输入回显到屏幕的文本字段很有用,例如输入密码的文本字段。
- 结果
-
true
如果此文本字段具有用于回显的字符集; 否则为false
。 - 另请参见:
-
setEchoChar(char)
,getEchoChar()
-
getColumns
public int getColumns()
获取此文本字段中的列数。 列是与平台相关的近似平均字符宽度。- 结果
- 列数。
- 从以下版本开始:
- 1.1
- 另请参见:
-
setColumns(int)
-
setColumns
public void setColumns(int columns)
设置此文本字段中的列数。 列是与平台相关的近似平均字符宽度。- 参数
-
columns
- 列数。 - 异常
-
IllegalArgumentException
- 如果为columns
提供的值小于0
。 - 从以下版本开始:
- 1.1
- 另请参见:
-
getColumns()
-
getPreferredSize
public Dimension getPreferredSize(int columns)
获取具有指定列数的此文本字段的首选大小。- 参数
-
columns
- 此文本字段中的列数。 - 结果
- 显示此文本字段的首选尺寸。
- 从以下版本开始:
- 1.1
-
preferredSize
@Deprecatedpublic Dimension preferredSize(int columns)
Deprecated.As of JDK version 1.1, replaced bygetPreferredSize(int)
.返回具有指定列数的此文本字段的首选大小。- 参数
-
columns
- 列数 - 结果
- 文本字段的首选大小
-
getPreferredSize
public Dimension getPreferredSize()
获取此文本字段的首选大小。- 重写:
-
getPreferredSize
在课程Component
- 结果
- 显示此文本字段的首选尺寸。
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getMinimumSize()
,LayoutManager
-
preferredSize
@Deprecatedpublic Dimension preferredSize()
Deprecated.As of JDK version 1.1, replaced bygetPreferredSize()
.复制自类的说明:Component
返回组件的首选大小。- 重写:
-
preferredSize
在课程Component
- 结果
- 组件的首选大小
-
getMinimumSize
public Dimension getMinimumSize(int columns)
获取具有指定列数的文本字段的最小尺寸。- 参数
-
columns
- 此文本字段中的列数。 - 结果
- 此文本字段的最小大小
- 从以下版本开始:
- 1.1
-
minimumSize
@Deprecatedpublic Dimension minimumSize(int columns)
Deprecated.As of JDK version 1.1, replaced bygetMinimumSize(int)
.返回具有指定列数的文本字段的最小尺寸。- 参数
-
columns
- 列数 - 结果
- 此文本字段的最小大小
-
getMinimumSize
public Dimension getMinimumSize()
获取此文本字段的最小尺寸。- 重写:
-
getMinimumSize
在类Component
- 结果
- 显示此文本字段的最小尺寸。
- 从以下版本开始:
- 1.1
- 另请参见:
-
Component.getPreferredSize()
,LayoutManager
-
minimumSize
@Deprecatedpublic Dimension minimumSize()
Deprecated.As of JDK version 1.1, replaced bygetMinimumSize()
.复制自类的说明:Component
返回此组件的最小大小。- 重写:
-
minimumSize
在类Component
- 结果
- 此组件的最小大小
-
addActionListener
public void addActionListener(ActionListener l)
- 参数
-
l
- 动作侦听器。 - 从以下版本开始:
- 1.1
- 另请参见:
-
removeActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionListener
-
removeActionListener
public void removeActionListener(ActionListener l)
- 参数
-
l
- 动作侦听器。 - 从以下版本开始:
- 1.1
- 另请参见:
-
addActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionListener
-
getActionListeners
public ActionListener[] getActionListeners()
返回在此文本字段上注册的所有动作侦听器的数组。- 结果
- 所有这个textfield的
ActionListener
s或如果当前没有注册动作侦听器的空数组 - 从以下版本开始:
- 1.4
- 另请参见:
-
addActionListener(java.awt.event.ActionListener)
,removeActionListener(java.awt.event.ActionListener)
,ActionListener
-
getListeners
public <T extends EventListener> T[] getListeners(类<T> listenerType)
返回当前注册的所有对象的数组FooListener
在这个STextField
。FooListener
s使用addFooListener
方法注册。您可以使用类文字指定
listenerType
参数,例如FooListener.class
。 例如,您可以使用以下代码查询TextField t
的动作侦听器:ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));
如果不存在此类侦听器,则此方法返回空数组。- 重写:
-
getListeners
类TextComponent
- 参数类型
-
T
- 侦听器的类型 - 参数
-
listenerType
- 请求的侦听器类型; 此参数应指定从java.util.EventListener
下降的接口 - 结果
-
FooListener
本字段上注册为FooListener
的所有对象的数组,如果未添加此类侦听器,则为空数组 - 异常
-
ClassCastException
- 如果listenerType
未指定实现java.util.EventListener
的类或接口 - 从以下版本开始:
- 1.3
- 另请参见:
-
getActionListeners()
-
processEvent
protected void processEvent(AWTEvent e)
处理此文本字段上的事件。 如果事件是ActionEvent
的实例,则调用processActionEvent
方法。 否则,它在超类上调用processEvent
。请注意,如果事件参数为
null
则行为未指定,可能会导致异常。- 重写:
-
processEvent
在课堂上TextComponent
- 参数
-
e
- 此次活动 - 从以下版本开始:
- 1.1
- 另请参见:
-
ActionEvent
,processActionEvent(java.awt.event.ActionEvent)
-
processActionEvent
protected void processActionEvent(ActionEvent e)
处理在此文本字段上发生的操作事件,方法是将它们分派给任何已注册的ActionListener
对象。除非为此组件启用了操作事件,否则不会调用此方法。 发生以下任一情况时启用操作事件:
-
ActionListener
对象是通过addActionListener
注册。 - 通过
enableEvents
启用操作事件。
请注意,如果事件参数为
null
则行为未指定,可能会导致异常。- 参数
-
e
- 动作事件 - 从以下版本开始:
- 1.1
- 另请参见:
-
ActionListener
,addActionListener(java.awt.event.ActionListener)
,Component.enableEvents(long)
-
-
paramString
protected String paramString()
返回表示此TextField
的状态的字符串。 此方法仅用于调试目的,返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在类TextComponent
- 结果
- 此文本字段的参数字符串
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
获取与此TextField关联的AccessibleContext。 对于文本字段,AccessibleContext采用AccessibleAWTTextField的形式。 如有必要,将创建一个新的AccessibleAWTTextField实例。- Specified by:
-
getAccessibleContext
在界面Accessible
- 重写:
-
getAccessibleContext
在类TextComponent
- 结果
- 一个AccessibleAWTTextField,用作此TextField的AccessibleContext
- 从以下版本开始:
- 1.3
-
-