jtextarea

TextArea 是一個顯示純文本的多行區域。它作為一個輕量級組件，提供與 java.awt.TextArea 類的源兼容性，理應如此。有關使用所有文本組件的信息和示例，請參閱《The Java Tutorial》中 Using Text Components一節。

基本介紹

• 外文名：jtextarea
• 類別：輕量級組件
• 相關文獻：《The Java Tutorial》
• 套用：文本顯示

套用

此組件具有 java.awt.TextArea 類中沒有的功能。有關其他功能，請參考超類。還有 JTextPane 和 JEditorPane 也是具有更多功能的多行文本類。 java.awt.TextArea 在內部處理滾動。JTextArea 的不同之處在於，它不管理滾動，但實現了 swing Scrollable 接口。這允許把它放置在 JScrollPane 的內部（如果需要滾動行為），或者直接使用（如果不需要滾動）。

java.awt.TextArea 具有換行能力。這由水平滾動策略來控制。由於滾動不是由 JTextArea 直接完成的，因此必須通過另一種方式來提供向後兼容性。JTextArea 具有用於換行的 bound 屬性，該屬性控制其是否換行。在默認情況下，換行屬性設定為 false（不換行）。 java.awt.TextArea 具有兩個屬性 rows 和 columns，這兩個屬性用來確定首選大小。JTextArea 用這些屬性來指示 viewport 的首選大小，此 viewport 被放置到 JScrollPane 中以匹配由 java.awt.TextArea 提供的功能。JTextArea 具有顯示所有文本所需的首選大小，以便在 JScrollPane 內部正常工作。如果 rows 或 columns 的值等於 0，則沿該軸的首選大小將用於沿相同軸上 viewport 的首選大小。 可以通過添加一個 TextEvent 的 TextListener 來對 java.awt.TextArea 的更改進行監視。在基於 JTextComponent 的組件中，更改通過 DocumentEvent 從模型傳播到 DocumentListeners。DocumentEvent 給出了更改的位置和更改種類（如果需要）。代碼片段如下所示：

DocumentListener myListener = new DocumentListener();

JTextArea myArea = new jTextArea();

myArea.getDocument().addDocumentListener(myListener);

構造方法

JTextArea(); 構造一個新的 TextArea。
JTextArea(Documentdoc); 構造一個新的 JTextArea，使其具有給定的文檔模型，所有其他參數均默認為 (null, 0, 0)。
JTextArea(Documentdoc, Stringtext, int rows, int columns); 構造具有指定行數和列數以及給定模型的新的 JTextArea。
JTextArea(int rows, int columns); 構造具有指定行數和列數的新的空 TextArea。
JTextArea(Stringtext); 構造顯示指定文本的新的 TextArea。
JTextArea(Stringtext, int rows, int columns); 構造具有指定文本、行數和列數的新的 TextArea。

方法摘要

void	append(Stringstr); 將給定文本追加到文檔結尾。
protected Document	createDefaultModel(); 如果沒有顯式給出構造時要使用的模型，則創建該模型的默認實現。
AccessibleContext	getAccessibleContext(); 獲取與此 JTextArea 關聯的 AccessibleContext。
int	getColumns(); 返回 TextArea 中的列數。
protected int	getColumnWidth(); 獲取列的寬度。
int	getLineCount(); 確定文本區中所包含的行數。
int	getLineEndOffset(int line); 確定給定行結尾處的偏移量。
int	getLineOfOffset(int offset); 將組件文本中的偏移量轉換為行號。
int	getLineStartOffset(int line); 確定給定行起始處的偏移量。
boolean	getLineWrap(); 獲取文本區的換行策略。
Dimension	getPreferredScrollableViewportSize(); 如果此組件被嵌入 JScrollPane 中，則返回 viewport 的首選大小。
Dimension	getPreferredSize(); 返回 TextArea 的首選大小。
protected int	getRowHeight(); 定義行高的意義。
int	getRows(); 返回 TextArea 中的行數。
boolean	getScrollableTracksViewportWidth(); 如果 viewport 總是強制要求此 Scrollable 的寬度與 viewport 的寬度相匹配，則返回 true。
int	getScrollableUnitIncrement(RectanglevisibleRect, int orientation, int direction); 顯示邏輯行或列的組件應根據方向的值計算滾動增量，此滾動增量將完全顯示一個新行或新列。
int	getTabSize(); 獲取用於擴展選項卡的字元數。
String	getUIClassID(); 返回 UI 的類 ID。
boolean	getWrapStyleWord(); 獲取換行方式（如果文本區要換行）。
void	insert(Stringstr, int pos); 將指定文本插入指定位置。
protected String	paramString(); 返回此 JTextArea 的字元串表示形式。
void	replaceRange(Stringstr, int start, int end); 用給定的新文本替換從指示的起始位置到結尾位置的文本。
void	setColumns(int columns); 設定此 TextArea 中的列數。
void	setFont(Fontf); 設定當前字型。
void	setLineWrap(boolean wrap); 設定文本區的換行策略。
void	setRows(int rows); 設定此 TextArea 的行數。
void	setTabSize(int size); 設定選項卡要擴大到的字元數。
void	setWrapStyleWord(boolean word); 設定換行方式（如果文本區要換行）。