java.awt
類別 TextArea

java.lang.Object
  java.awt.Component
      java.awt.TextComponent
          java.awt.TextArea

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, Accessible

public class TextArea
extends TextComponent

TextArea 物件是顯示文本的多行區域。可以將它設置為允許編輯或只讀。

下圖顯示了文本區的外觀：

此文本區可以使用以下程式碼行來創建：

 new TextArea("Hello", 5, 40);
 

從以下版本開始：

JDK1.0

另請參見：

序列化表格

巢狀類別摘要

protected class

TextArea.AccessibleAWTTextArea 此類別實作 TextArea 類別的可存取性支持。

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

TextComponent.AccessibleAWTTextComponent

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

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

欄位摘要

static int	SCROLLBARS_BOTH 創建並顯示垂直和水平滾動條。
static int	SCROLLBARS_HORIZONTAL_ONLY 只創建並顯示水平滾動條。
static int	SCROLLBARS_NONE 不為文本區創建或顯示任何滾動條。
static int	SCROLLBARS_VERTICAL_ONLY 只創建並顯示垂直滾動條。

從類別 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

建構子摘要

TextArea()
建構一個將空字元串作為文本的新文本區。

TextArea(int rows, int columns)
建構一個新文本區，該文本區具有指定的行數和列數，並將空字元串作為文本。

TextArea(String text)
建構具有指定文本的新文本區。

TextArea(String text, int rows, int columns)
建構一個新文本區，該文本區具有指定的文本，以及指定的行數和列數。

TextArea(String text, int rows, int columns, int scrollbars)
建構一個新文本區，該文本區具有指定的文本，以及指定的行數、列數和滾動條可見性。

方法摘要

void	addNotify() 創建 TextArea 的同位體。
void	append(String str) 將給定文本追加到文本區的當前文本。
void	appendText(String str) 已過時。 從 JDK version 1.1 開始，由 append(String) 取代。
AccessibleContext	getAccessibleContext() 返回與此 TextArea 相關的 AccessibleContext。
int	getColumns() 返回此文本區中的列數。
Dimension	getMinimumSize() 確定此文本區的最小大小。
Dimension	getMinimumSize(int rows, int columns) 確定具有指定行數和列數的文本區的最小大小。
Dimension	getPreferredSize() 確定此文本區的首選大小。
Dimension	getPreferredSize(int rows, int columns) 確定具有指定行數和列數的文本區的首選大小。
int	getRows() 返回此文本區的行數。
int	getScrollbarVisibility() 返回指示文本區使用何種滾動條的列舉值。
void	insert(String str, int pos) 在此文本區的指定位置插入指定文本。
void	insertText(String str, int pos) 已過時。 從 JDK version 1.1 開始，由 insert(String, int) 取代。
Dimension	minimumSize() 已過時。 從 JDK version 1.1 開始，由 getMinimumSize() 取代。
Dimension	minimumSize(int rows, int columns) 已過時。 從 JDK version 1.1 開始，由 getMinimumSize(int, int) 取代。
protected String	paramString() 返回表示此 TextArea 狀態的字元串。
Dimension	preferredSize() 已過時。 從 JDK version 1.1 開始，由 getPreferredSize() 取代。
Dimension	preferredSize(int rows, int columns) 已過時。 從 JDK version 1.1 開始，由 getPreferredSize(int, int) 取代。
void	replaceRange(String str, int start, int end) 用指定替換文本替換指定開始位置與結束位置之間的文本。
void	replaceText(String str, int start, int end) 已過時。 從 JDK version 1.1 開始，由 replaceRange(String, int, int) 取代。
void	setColumns(int columns) 設置此文本區的列數。
void	setRows(int rows) 設置此文本區的行數。

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

addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getListeners, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText

從類別 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

欄位詳細資訊

SCROLLBARS_BOTH

public static final int SCROLLBARS_BOTH

創建並顯示垂直和水平滾動條。

從以下版本開始：

JDK1.1

另請參見：

常數欄位值

SCROLLBARS_VERTICAL_ONLY

public static final int SCROLLBARS_VERTICAL_ONLY

只創建並顯示垂直滾動條。

從以下版本開始：

JDK1.1

另請參見：

常數欄位值

SCROLLBARS_HORIZONTAL_ONLY

public static final int SCROLLBARS_HORIZONTAL_ONLY

只創建並顯示水平滾動條。

從以下版本開始：

JDK1.1

另請參見：

常數欄位值

SCROLLBARS_NONE

public static final int SCROLLBARS_NONE

不為文本區創建或顯示任何滾動條。

從以下版本開始：

JDK1.1

另請參見：

常數欄位值

建構子詳細資訊

TextArea

public TextArea()
         throws HeadlessException

建構一個將空字元串作為文本的新文本區。此文本區是在滾動條可見性等於 SCROLLBARS_BOTH 的情況下創建的，所以垂直滾動條和水平滾動條對於文本區都將是可視的。

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

另請參見：

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text)
         throws HeadlessException

建構具有指定文本的新文本區。文本區是在滾動條可見性等於 SCROLLBARS_BOTH 的情況下創建的，所以垂直滾動條和水平滾動條對於文本區都將是可視的。

參數：

text - 要顯示的文本；如果 text 為 null，則顯示空字元串 ""

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

另請參見：

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException

建構一個新文本區，該文本區具有指定的行數和列數，並將空字元串作為文本。列是近似平均字元寬度，它與平臺有關。文本區是在滾動條可見性等於 SCROLLBARS_BOTH 的情況下創建的，所以垂直滾動條和水平滾動條對於文本區都將是可視的。

參數：

rows - 行數

columns - 列數

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

另請參見：

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns)
         throws HeadlessException

建構一個新文本區，該文本區具有指定的文本，以及指定的行數和列數。列是近似平均字元寬度，它與平臺有關。文本區是在滾動條可見性等於 SCROLLBARS_BOTH 的情況下創建的，所以垂直滾動條和水平滾動條對於文本區都將是可視的。

參數：

text - 要顯示的文本；如果 text 為 null，則顯示空字元串 ""

rows - 行數

columns - 列數

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

另請參見：

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns,
                int scrollbars)
         throws HeadlessException

建構一個新文本區，該文本區具有指定的文本，以及指定的行數、列數和滾動條可見性。所有 TextArea 建構子都服從這一規定。

TextArea 類別定義一些可以作為 scrollbars 參數值提供的常數：

• SCROLLBARS_BOTH,
• SCROLLBARS_VERTICAL_ONLY,
• SCROLLBARS_HORIZONTAL_ONLY,
• SCROLLBARS_NONE.

其他所有用於 scrollbars 參數的值都是無效的，並會使創建此文本區時使用的滾動條可見性等於 SCROLLBARS_BOTH 的預設值。

參數：

text - 要顯示的文本；如果 text 為 null，則顯示空字元串 ""

rows - 行數；如果 rows 小於 0，則將 rows 設置為 0

columns - 列數；如果 columns 小於 0，則將 columns 設置為 0

scrollbars - 確定為查看文本區創建的滾動條型別的常數

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true

從以下版本開始：

JDK1.1

另請參見：

GraphicsEnvironment.isHeadless()

方法詳細資訊

addNotify

public void addNotify()

創建 TextArea 的同位體。該同位體允許修改 TextArea 的外觀，而不更改其功能。

覆寫：

類別 TextComponent 中的 addNotify

另請參見：

TextComponent.removeNotify()

insert

public void insert(String str,
                   int pos)

在此文本區的指定位置插入指定文本。

注意，傳遞 null 或不一致的參數是無效的，並且將導致不確定的行為。

參數：

str - 要插入的非 null 文本

pos - 插入的位置

從以下版本開始：

JDK1.1

另請參見：

TextComponent.setText(java.lang.String), replaceRange(java.lang.String, int, int), append(java.lang.String)

insertText

@Deprecated
public void insertText(String str,
                                  int pos)

已過時。 從 JDK version 1.1 開始，由 insert(String, int) 取代。

append

public void append(String str)

將給定文本追加到文本區的當前文本。

注意，傳遞 null 或不一致的參數是無效的，並且將導致不確定的行為。

參數：

str - 要追加的非 null 文本

從以下版本開始：

JDK1.1

另請參見：

insert(java.lang.String, int)

appendText

@Deprecated
public void appendText(String str)

已過時。 從 JDK version 1.1 開始，由 append(String) 取代。

replaceRange

public void replaceRange(String str,
                         int start,
                         int end)

用指定替換文本替換指定開始位置與結束位置之間的文本。結束處的文本不會被替換。開始位置處的文本會被替換（除非開始位置與結束位置相同）。文本位置是從零開始的。插入子字元串的長度可以與所替換文本的長度不同。

注意，傳遞 null 或不一致的參數是無效的，並且將導致不確定的行為。

參數：

str - 用於替換的非 null 文本

start - 開始位置

end - 結束位置

從以下版本開始：

JDK1.1

另請參見：

insert(java.lang.String, int)

replaceText

@Deprecated
public void replaceText(String str,
                                   int start,
                                   int end)

已過時。 從 JDK version 1.1 開始，由 replaceRange(String, int, int) 取代。

getRows

public int getRows()

返回此文本區的行數。

返回：

此文本區中的行數

從以下版本開始：

JDK1

另請參見：

setRows(int), getColumns()

setRows

public void setRows(int rows)

設置此文本區的行數。

參數：

rows - 行數

拋出：

IllegalArgumentException - 如果為 rows 提供的值小於 0

從以下版本開始：

JDK1.1

另請參見：

getRows(), setColumns(int)

getColumns

public int getColumns()

返回此文本區中的列數。

返回：

此文本區中的列數

另請參見：

setColumns(int), getRows()

setColumns

public void setColumns(int columns)

設置此文本區的列數。

參數：

columns - 列數

拋出：

IllegalArgumentException - 如果為 columns 提供的值小於 0

從以下版本開始：

JDK1.1

另請參見：

getColumns(), setRows(int)

getScrollbarVisibility

public int getScrollbarVisibility()

返回指示文本區使用何種滾動條的列舉值。

TextArea 類別定義了四個整數常數，用來指定哪些滾動條是可用的。TextArea 有一個給出滾動條上的應用方向的建構子。

返回：

指示使用哪種滾動條的整數

從以下版本開始：

JDK1.1

另請參見：

SCROLLBARS_BOTH, SCROLLBARS_VERTICAL_ONLY, SCROLLBARS_HORIZONTAL_ONLY, SCROLLBARS_NONE, TextArea(java.lang.String, int, int, int)

getPreferredSize

public Dimension getPreferredSize(int rows,
                                  int columns)

確定具有指定行數和列數的文本區的首選大小。

參數：

rows - 行數

columns - 列數

返回：

顯示具有指定行數和列數的文本區所需的首選尺寸

從以下版本開始：

JDK1.1

另請參見：

Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize(int rows,
                                          int columns)

已過時。 從 JDK version 1.1 開始，由 getPreferredSize(int, int) 取代。

getPreferredSize

public Dimension getPreferredSize()

確定此文本區的首選大小。

覆寫：

類別 Component 中的 getPreferredSize

返回：

此文本區所需的首選尺寸

從以下版本開始：

JDK1.1

另請參見：

Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()

已過時。 從 JDK version 1.1 開始，由 getPreferredSize() 取代。

覆寫：

類別 Component 中的 preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows,
                                int columns)

確定具有指定行數和列數的文本區的最小大小。

參數：

rows - 行數

columns - 列數

返回：

顯示具有指定行數和列數的文本區所需的最小尺寸

從以下版本開始：

JDK1.1

另請參見：

Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows,
                                        int columns)

已過時。 從 JDK version 1.1 開始，由 getMinimumSize(int, int) 取代。

getMinimumSize

public Dimension getMinimumSize()

確定此文本區的最小大小。

覆寫：

類別 Component 中的 getMinimumSize

返回：

此文本區所需的首選尺寸

從以下版本開始：

JDK1.1

另請參見：

Component.getPreferredSize()

minimumSize

@Deprecated
public Dimension minimumSize()

已過時。 從 JDK version 1.1 開始，由 getMinimumSize() 取代。

覆寫：

類別 Component 中的 minimumSize

paramString

protected String paramString()

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

覆寫：

類別 TextComponent 中的 paramString

返回：

此文本區的參數字元串

getAccessibleContext

public AccessibleContext getAccessibleContext()

返回與此 TextArea 相關的 AccessibleContext。對於文本區，AccessibleContext 採用 AccessibleAWTTextArea 的形式。如有必要，可創建一個新的 AccessibleAWTTextArea 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 TextComponent 中的 getAccessibleContext

返回：

用作此 TextArea 的 AccessibleContext 的 AccessibleAWTTextArea

從以下版本開始：

1.3