java.awt
类 TextField

java.lang.Object
  java.awt.Component
      java.awt.TextComponent
          java.awt.TextField

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

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

每次用户在文本字段中键入一个键时，就有一个或更多键事件被发送到该文本字段。KeyEvent 是以下三种类型之一：keyPressed、keyReleased 或 keyTyped。键事件的属性指示事件是哪一种类型，以及关于事件的其他信息，比如对键事件应用哪种修饰符和事件发生的时间。

键事件被传递给每一个 KeyListener 或 KeyAdapter 对象，这些对象使用组件的 addKeyListener 方法注册，以接收这类事件。（KeyAdapter 对象实现 KeyListener 接口。）

TextField 还可能触发 ActionEvent。如果对文本字段启用操作事件，则可以通过按下 Return 键触发它们。

TextField 类的 processEvent 方法检查操作事件，并将它们传递给 processActionEvent。后一种方法将该事件重定向到为接收此文本字段生成的操作事件而注册的所有 ActionListener 对象。

从以下版本开始：

JDK1.0

另请参见：

KeyEvent, KeyAdapter, KeyListener, ActionEvent, Component.addKeyListener(java.awt.event.KeyListener), processEvent(java.awt.AWTEvent), processActionEvent(java.awt.event.ActionEvent), addActionListener(java.awt.event.ActionListener), 序列化表格

TextField

public TextField()
          throws HeadlessException

构造新文本字段。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless()

TextField

public TextField(String text)
          throws HeadlessException

构造使用指定文本初始化的新文本字段。

参数：

text - 要显示的文本。如果 text 为 null，则显示空字符串 ""。

抛出：

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，则显示空字符串 ""。

columns - 列数。如果 columns 小于 0，则将 columns 设置为 0。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless()

addNotify

public void addNotify()

创建 TextField 的同位体。此同位体允许修改 TextField 的外观，并且不更改其功能。

覆盖：

类 TextComponent 中的 addNotify

另请参见：

TextComponent.removeNotify()

getEchoChar

public char getEchoChar()

获取用于回显的字符。

回显字符对于不应将用户输入回显到屏幕上的文本字段有用，例如输入密码的文本字段。如果 echoChar = 0，则将用户输入不作更改地回显到屏幕。

Java 平台实现只能支持有限的、非空回显字符集。此函数返回 setEchoChar() 最初请求的回显字符。TextField 实现实际使用的回显字符可能不同。

返回：

此文本字段的回显字符。

另请参见：

echoCharIsSet(), setEchoChar(char)

setEchoChar

public void setEchoChar(char c)

设置此文本字段的回显字符。

回显字符对于不应将用户输入回显到屏幕上的文本字段很有用，例如输入密码的文本字段。设置 echoChar = 0 允许将用户输入再次回显到屏幕。

Java 平台实现只能支持有限的、非空回显字符集。试图设置不受支持的回显字符将导致使用默认回显字符。对 getEchoChar() 的后续调用将返回最初请求的回显字符。返回的回显字符有可能与 TextField 实现实际使用的相同，也有可能不同。

参数：

c - 此文本字段的回显字符。

从以下版本开始：

JDK1.1

另请参见：

echoCharIsSet(), getEchoChar()

setEchoCharacter

@Deprecated
public void setEchoCharacter(char c)

已过时。  从 JDK version 1.1 开始，由 setEchoChar(char) 取代。

setText

public void setText(String t)

将此文本组件显示的文本设置为指定文本。

覆盖：

类 TextComponent 中的 setText

参数：

t - 新文本。

另请参见：

TextComponent.getText()

echoCharIsSet

public boolean echoCharIsSet()

指示此文本字段是否有一个回显字符集。

回显字符对于不应将用户输入回显到屏幕上的文本字段有用，例如输入密码的文本字段。

返回：

如果此文本字段有一个回显字符集，则返回 true；否则返回 false。

另请参见：

setEchoChar(char), getEchoChar()

getColumns

public int getColumns()

获取此文本字段中的列数。列是近似平均字符宽度，它与平台有关。

返回：

列数。

从以下版本开始：

JDK1.1

另请参见：

setColumns(int)

setColumns

public void setColumns(int columns)

设置此文本字段中的列数。列是近似平均字符宽度，它与平台有关。

参数：

columns - 列数。

抛出：

IllegalArgumentException - 如果为 columns 提供的值小于 0。

从以下版本开始：

JDK1.1

另请参见：

getColumns()

getPreferredSize

public Dimension getPreferredSize(int columns)

获取具有指定列数的文本字段的首选大小。

参数：

columns - 此文本字段中的列数。

返回：

显示此文本字段的首选尺寸。

从以下版本开始：

JDK1.1

preferredSize

@Deprecated
public Dimension preferredSize(int columns)

已过时。  从 JDK version 1.1 开始，由 getPreferredSize(int) 取代。

getPreferredSize

public Dimension getPreferredSize()

获取此文本字段的首选大小。

覆盖：

类 Component 中的 getPreferredSize

返回：

显示此文本字段的首选尺寸。

从以下版本开始：

JDK1.1

另请参见：

Component.getMinimumSize(), LayoutManager

preferredSize

@Deprecated
public Dimension preferredSize()

已过时。  从 JDK version 1.1 开始，由 getPreferredSize() 取代。

覆盖：

类 Component 中的 preferredSize

getMinimumSize

public Dimension getMinimumSize(int columns)

获取具有指定列数的文本字段的最小尺寸。

参数：

columns - 此文本字段中的列数。

从以下版本开始：

JDK1.1

minimumSize

@Deprecated
public Dimension minimumSize(int columns)

已过时。  从 JDK version 1.1 开始，由 getMinimumSize(int) 取代。

getMinimumSize

public Dimension getMinimumSize()

获取此文本字段的最小尺寸。

覆盖：

类 Component 中的 getMinimumSize

返回：

显示此文本字段的最小尺寸。

从以下版本开始：

JDK1.1

另请参见：

Component.getPreferredSize(), LayoutManager

minimumSize

@Deprecated
public Dimension minimumSize()

已过时。  从 JDK version 1.1 开始，由 getMinimumSize() 取代。

覆盖：

类 Component 中的 minimumSize

addActionListener

public void addActionListener(ActionListener l)

添加指定的操