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), 序列化表格

巢狀類別摘要

protected class

TextField.AccessibleAWTTextField 此類別實作 TextField 類別的可存取性支持。

從類別 java.awt.TextComponent 繼承的巢狀類別/介面

TextComponent.AccessibleAWTTextComponent

從類別 java.awt.Component 繼承的巢狀類別/介面

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

欄位摘要

從類別 java.awt.TextComponent 繼承的欄位

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

建構子摘要

TextField()
建構新文本欄位。

TextField(int columns)
建構具有指定列數的新空文本欄位。

TextField(String text)
建構使用指定文本初始化的新文本欄位。

TextField(String text, int columns)
建構使用要顯示的指定文本初始化的新文本欄位，寬度足夠容納指定列數。

方法摘要

void	addActionListener(ActionListener l) 添加指定的操作偵聽器，以從此文本欄位接收操作事件。
void	addNotify() 創建 TextField 的同位體。
boolean	echoCharIsSet() 指示此文本欄位是否有一個回顯字元集。
AccessibleContext	getAccessibleContext() 獲取與此 TextField 關聯的 AccessibleContext。
ActionListener[]	getActionListeners() 返回此文本欄位上已註冊的所有操作偵聽器的陣列。
int	getColumns() 獲取此文本欄位中的列數。
char	getEchoChar() 獲取用於回顯的字元。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) 返回當前已在此 TextField 上註冊為 FooListener 的所有物件的陣列。
Dimension	getMinimumSize() 獲取此文本欄位的最小尺寸。
Dimension	getMinimumSize(int columns) 獲取具有指定列數的文本欄位的最小尺寸。
Dimension	getPreferredSize() 獲取此文本欄位的首選大小。
Dimension	getPreferredSize(int columns) 獲取具有指定列數的文本欄位的首選大小。
Dimension	minimumSize() 已過時。 從 JDK version 1.1 開始，由 getMinimumSize() 取代。
Dimension	minimumSize(int columns) 已過時。 從 JDK version 1.1 開始，由 getMinimumSize(int) 取代。
protected String	paramString() 返回表示此 TextField 狀態的字元串。
Dimension	preferredSize() 已過時。 從 JDK version 1.1 開始，由 getPreferredSize() 取代。
Dimension	preferredSize(int columns) 已過時。 從 JDK version 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 version 1.1 開始，由 setEchoChar(char) 取代。
void	setText(String t) 將此文本元件顯示的文本設置為指定文本。

從類別 java.awt.TextComponent 繼承的方法

addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, 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, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, 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

建構子詳細資訊

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 平臺實作只能支持有限的、非空(null)回顯字元集。此函數返回 setEchoChar() 最初請求的回顯字元。TextField 實作實際使用的回顯字元可能不同。

返回：

此文本欄位的回顯字元。

另請參見：

echoCharIsSet(), setEchoChar(char)

setEchoChar

public void setEchoChar(char c)

設置此文本欄位的回顯字元。

回顯字元對於不應將使用者輸入回顯到螢幕上的文本欄位很有用，例如輸入密碼的文本欄位。設置 echoChar = 0 允許將使用者輸入再次回顯到螢幕。

Java 平臺實作只能支持有限的、非空(null)回顯字元集。試圖設置不受支持的回顯字元將導致使用預設回顯字元。對 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)

添加指定的操作偵聽器，以從此文本欄位接收操作事件。如果 l 為 null，則不拋出任何異常，也不執行任何操作。

有關 AWT 執行緒網要的詳細資訊，請參考 AWT Threading Issues。

參數：

l - 操作偵聽器。

從以下版本開始：

JDK1.1

另請參見：

removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

移除指定的操作偵聽器，不再從此文本欄位接收操作事件。如果 l 為 null，則不拋出任何異常，也不執行任何操作。

有關 AWT 執行緒網要的詳細資訊，請參考 AWT Threading Issues。

參數：

l - 操作偵聽器。

從以下版本開始：

JDK1.1

另請參見：

addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

getActionListeners

public ActionListener[] getActionListeners()

返回此文本欄位上已註冊的所有操作偵聽器的陣列。

返回：

此文本欄位的所有 ActionListener；如果當前沒有註冊任何操作偵聽器，則返回一個空陣列。

從以下版本開始：

1.4

另請參見：

addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), java.awt.event

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回當前已在此 TextField 上註冊為 FooListener 的所有物件的陣列。FooListener 是用 addFooListener 方法註冊的。

可以使用 class 文字值（如 FooListener.class）來指定 listenerType 參數。例如，可以使用以下程式碼來查詢 TextField t 的操作偵聽器：

ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));

如果不存在這樣的偵聽器，則此方法將返回一個空陣列。

覆寫：

類別 TextComponent 中的 getListeners

參數：

listenerType - 所請求的偵聽器型別；此參數應該指定一個從 java.util.EventListener 繼承的介面

返回：

在此文本欄位上作為 FooListener 註冊的所有物件的陣列；如果尚未添加這樣的偵聽器，則返回一個空陣列

拋出：

ClassCastException - 如果 listenerType 未指定一個實作 java.util.EventListener 的類別或介面

從以下版本開始：

1.3

另請參見：

getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

處理此文本欄位上的事件。如果事件是 ActionEvent 的一個實例，則此方法將調用 processActionEvent 方法。否則，它將調用父級類別的 processEvent 方法。

注意，如果事件參數為 null，則行為是不明確的，並可能導致異常。

覆寫：

類別 TextComponent 中的 processEvent

參數：

e - 事件

從以下版本開始：

JDK1.1

另請參見：

ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

處理發生在此文本欄位上的操作事件：將這些事件指派給所有已註冊的 ActionListener 物件。

只有此元件啟用了操作事件時，才調用此方法。發生以下事件之一時將啟用操作事件：

• ActionListener 物件通過 addActionListener 註冊。
• 操作事件通過 enableEvents 啟用。

注意，如果事件參數為 null，則行為是不明確的，並可能導致異常。

參數：

e - 操作事件

從以下版本開始：

JDK1.1

另請參見：

ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

返回表示此 TextField 狀態的字元串。此方法僅用於除錯目的，對於各個實作，返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 TextComponent 中的 paramString

返回：

此文本欄位的參數字元串

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 TextField 關聯的 AccessibleContext。對於文本欄位，AccessibleContext 採用 AccessibleAWTTextField 的形式。如有必要，可創建一個新的 AccessibleAWTTextField 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 TextComponent 中的 getAccessibleContext

返回：

一個 AccessibleAWTTextField，它充當此 TextField 的 AccessibleContext。

從以下版本開始：

1.3