类 java.awt.TextField

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.TextComponent
                   |
                   +----java.awt.TextField

public class TextField

extends 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);
 

当用户在文本域内敲下一个键时，AWT 将向文本域发送两个动作事件。第一个表示键按下，第二个表示键释放。每个动作事件都体现了某时刻的系统状态。每个动作事件的属性将指示哪一个键被按下、哪个修饰键也被按下和此事件发生的时刻。

因为此事件是 ActionEvent 的一个实例, 所以类 ActionEvent 的 processEvent 方法将检查该事件，并将它传递给 processActionEvent 方法。 后面的方法又将该事件重定向到任一个对此文本域产生的动作事件感兴趣的 ActionListener 对象。

来自：

JDK1.0

参见：

ActionEvent, processEvent, processActionEvent

构造子索引

TextField()

创建一个新的文本域。

TextField(int)

用指定列数创建一个新的空文本域。

TextField(String)

创建一个新的文本域，并用指定文本初始化。

TextField(String, int)

创建一个新的文本域，并用待显示的指定文本初始化，且它的宽度足以显示指定字符数。

方法索引

addActionListener(ActionListener)

添加指定的动作监听者，接收当前文本域的动作事件。

addNotify()

创建文本域的同级件。

echoCharIsSet()

指示当前文本域是否有一个回响字符集。

getColumns()

获取当前文本域的列数。

getEchoChar()

获取将使用的回响字符。

getMinimumSize()

获取当前文本域的最小尺寸。

getMinimumSize(int)

获取指定列数的文本域的最小尺寸。

getPreferredSize()

获取当前文本区域的最佳尺寸。

getPreferredSize(int)

获取指定列数的文本域的最佳尺寸。

minimumSize()

不推荐使用该方法。

minimumSize(int)

不推荐使用该方法。

paramString()

返回表示当前文本域状态的参数串。

preferredSize()

不推荐使用该方法。

preferredSize(int)

不推荐使用该方法。

processActionEvent(ActionEvent)

处理发生在当前文本域上的动作事件，将它们分配给任一已登记的 ActionListener 对象。

processEvent(AWTEvent)

处理当前文本域的事件。

removeActionListener(ActionListener)

删除指定的动作监听者，使之不再接收当前文本域的动作事件。

setColumns(int)

设置当前文本域的列数。

setEchoChar(char)

设置当前文本域的回响字符。

setEchoCharacter(char)

不推荐使用该方法。

构造子

 public TextField()

创建一个新的文本域。

 public TextField(String text)

创建一个新的文本域，并用指定文本初始化。

参数：

text - 显示的文本。

 public TextField(int columns)

用指定列数创建一个新的空文本域。

参数：

columns - 列数

 public TextField(String text,
                  int columns)

创建一个新的文本域，并用待显示的指定文本初始化，且它的宽度足以显示指定的字符数。

参数：

text - 显示的文本。

columns - 字符数。

方法

 public void addNotify()

创建文本域的同级件。该同级件允许在不改变文本域功能的情况下改变其外观。

覆盖：

类 Component 中的 addNotify

 public char getEchoChar()

获取将使用的回响字符。

在用户输入不应显示在屏幕上的地方，使用一个回响字符，例如输入一个口令的文本域。

返回值：

当前文本域的回响字符。

参见：

echoCharIsSet, setEchoChar

 public synchronized void setEchoChar(char c)

设置当前文本域的回响字符。

在用户输入不应显示在屏幕上的地方，使用一个回响字符，例如输入一个口令的文本域。

参数：

c - 当前文本域的回响字符。

参见：

echoCharIsSet, getEchoChar

 public void setEchoCharacter(char c)

注释：不推荐使用 setEchoCharacter() 方法。 同 JDK 1.1 版类似, 用 setEchoChar(char) 方法替换。

 public boolean echoCharIsSet()

指示当前文本域是否有一个回响字符集。

在用户输入不应显示在屏幕上的地方，使用一个回响字符，例如输入一个口令的文本域。

返回值：

如果当前文本域有一个回响字符集则为 true；否则为 false。

参见：

setEchoChar, getEchoChar

 public int getColumns()

获取当前文本域的列数。

返回值：

列数。

参见：

setColumns

 public synchronized void setColumns(int columns)

设置当前文本域的列数。

参数：

columns - 列数

抛出： IllegalArgumentException

如果给定的 columns 值小于零。

参见：

getColumns

 public synchronized Dimension getPreferredSize(int columns)

获取指定列数的文本域的最佳尺寸。

参数：

columns - 当前文本域的列数。

返回值：

显示当前文本域的最佳尺寸。

 public synchronized Dimension preferredSize(int columns)

注释：不推荐使用 preferredSize()。 如同 JDK 1.1 版，用 getPreferredSize(int) 替换。

 public Dimension getPreferredSize()

获取当前文本区域的最佳尺寸。

返回值：

显示当前文本域的最佳尺寸。

覆盖：

类 Component 中的 getPreferredSize

 public synchronized Dimension preferredSize()

注释：不推荐使用 preferredSize()。 如同 JDK 1.1 版，用 getPreferredSize() 替换。

覆盖：

类 Component 中的 preferredSize

 public Dimension getMinimumSize(int columns)

获取指定列数的文本域的最小尺寸。

参数：

columns - 当前文本域的列数。

 public synchronized Dimension minimumSize(int columns)

注释：不推荐使用 minimumSize()。 如同 JDK 1.1 版，用 getMinimumSize(int) 替换。

 public Dimension getMinimumSize()

获取当前文本域的最小尺寸。

返回值：

显示当前文本域的最小尺寸。

覆盖：

类 Component 中的 getMinimumSize

 public synchronized Dimension minimumSize()

注释：不推荐使用 minimumSize()。 如同 JDK 1.1 版，用 getMinimumSize() 替换。

覆盖：

类 Component 中的 minimumSize

 public synchronized void addActionListener(ActionListener l)

添加指定的动作监听者，接收当前文本域的动作事件。

参数：

l - 动作监听者。

参见：

ActionListener, removeActionListener

 public synchronized void removeActionListener(ActionListener l)

删除指定的动作监听者，使之不再接收当前文本域的动作事件。

参数：

l - 动作监听者。

参见：

ActionListener, addActionListener

 protected void processEvent(AWTEvent e)

处理当前文本域的事件。 若事件是 ActionEvent 的一个实例，该方法调用 processActionEvent 方法。 否则，它将调用其父类中的 processEvent 方法。

参数：

e - 事件。

覆盖：

类 TextComponent 中 processEvent

参见：

ActionEvent, processActionEvent

 protected void processActionEvent(ActionEvent e)

处理发生在当前文本域上的动作事件，将它们分配给任一已登记的 ActionListener 对象。

除非动作事件对此组件是有效的，否则不能调用此方法。 当如下条件之一发生时，动作事件是有效的：

• 通过 addActionListener 方法，登记了一个 ActionListener 对象。
• 通过执行 enableEvents 方法使动作事件有效。

参数：

e - 动作事件。

参见：

ActionListener, addActionListener, enableEvents

 protected String paramString()

返回表示当前文本域状态的参数串。 该字符串对调试有用。

返回值：

表示当前文本域的参数串。

覆盖：

类 TextComponent 中的 paramString