Java java.awt 类 TextField（JDK5）

所有类

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，则将用户输入不作更改地回送到屏幕。

返回：

此文本字段的回送字符。

另请参见：

echoCharIsSet(), setEchoChar(char)