|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一個類別 下一個類別 | 框架 無框架 | |||||||||
| 摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 | |||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JTextArea
public class JTextArea
JTextArea 是一個顯示純文本的多行區域。它作為一個輕量級元件,提供與 java.awt.TextArea 類別的源相容性,理應如此。有關使用所有文本元件的資訊和範例,請參閱 The Java Tutorial 中 Using Text Components 一節。
此元件具有 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 = ??;
JTextArea myArea = ??;
myArea.getDocument().addDocumentListener(myListener);
警告:Swing 不是執行緒安全的。有關更多資訊,請參閱 Swing's Threading Policy。
警告:此類別的已序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲,或適用於在運行相同 Swing 版本的應用程序之間進行 RMI(Remote Method Invocation,遠端方法調用)。從 1.4 版本開始,已在 java.beans 套件中添加了支持所有 JavaBeansTM 長期存儲的功能。請參見 XMLEncoder。
JTextPane,
JEditorPane| 巢狀類別摘要 | |
|---|---|
protected class |
JTextArea.AccessibleJTextArea
此類別實作對 JTextArea 類別的可存取性支持。 |
| 從類別 javax.swing.text.JTextComponent 繼承的巢狀類別/介面 |
|---|
JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding |
| 從類別 javax.swing.JComponent 繼承的巢狀類別/介面 |
|---|
JComponent.AccessibleJComponent |
| 從類別 java.awt.Container 繼承的巢狀類別/介面 |
|---|
Container.AccessibleAWTContainer |
| 從類別 java.awt.Component 繼承的巢狀類別/介面 |
|---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
| 欄位摘要 |
|---|
| 從類別 javax.swing.text.JTextComponent 繼承的欄位 |
|---|
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY |
| 從類別 javax.swing.JComponent 繼承的欄位 |
|---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
| 從類別 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 |
| 建構子摘要 | |
|---|---|
JTextArea()
建構新的 TextArea。 |
|
JTextArea(Document doc)
建構新的 JTextArea,使其具有給定的文檔模型,所有其他參數均預設為 (null, 0, 0)。 |
|
JTextArea(Document doc,
String text,
int rows,
int columns)
建構具有指定行數和列數以及給定模型的新的 JTextArea。 |
|
JTextArea(int rows,
int columns)
建構具有指定行數和列數的新的空 TextArea。 |
|
JTextArea(String text)
建構顯示指定文本的新的 TextArea。 |
|
JTextArea(String text,
int rows,
int columns)
建構具有指定文本、行數和列數的新的 TextArea。 |
|
| 方法摘要 | |
|---|---|
void |
append(String str)
將給定文本追加到文檔結尾。 |
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(Rectangle visibleRect,
int orientation,
int direction)
顯示邏輯行或列的元件應根據方向的值計算滾動增量,此滾動增量將完全顯示一個新行或新列。 |
int |
getTabSize()
獲取用於擴展選項卡的字元數。 |
String |
getUIClassID()
返回 UI 的類別 ID。 |
boolean |
getWrapStyleWord()
獲取換行方式(如果文本區要換行)。 |
void |
insert(String str,
int pos)
將指定文本插入指定位置。 |
protected String |
paramString()
返回此 JTextArea 的字元串表示形式。 |
void |
replaceRange(String str,
int start,
int end)
用給定的新文本替換從指示的起始位置到結尾位置的文本。 |
void |
setColumns(int columns)
設置此 TextArea 中的列數。 |
void |
setFont(Font f)
設置當前字體。 |
void |
setLineWrap(boolean wrap)
設置文本區的換行策略。 |
void |
setRows(int rows)
設置此 TextArea 的行數。 |
void |
setTabSize(int size)
設置選項卡要擴大到的字元數。 |
void |
setWrapStyleWord(boolean word)
設置換行方式(如果文本區要換行)。 |
| 從類別 java.lang.Object 繼承的方法 |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| 建構子詳細資訊 |
|---|
public JTextArea()
public JTextArea(String text)
text - 要顯示的文本,或者為 null
public JTextArea(int rows,
int columns)
rows - 行數 >= 0columns - 列數 >= 0
IllegalArgumentException - 如果行或列參數為負數。
public JTextArea(String text,
int rows,
int columns)
text - 要顯示的文本,或者為 nullrows - 行數 >= 0columns - 列數 >= 0
IllegalArgumentException - 如果行或列參數為負數。public JTextArea(Document doc)
doc - 要使用的模型
public JTextArea(Document doc,
String text,
int rows,
int columns)
doc - 要使用的模型,如果為 null,則創建一個預設的模型text - 要顯示的文本,如果沒有文本,則為 nullrows - 行數 >= 0columns - 列數 >= 0
IllegalArgumentException - 如果行或列參數為負數。| 方法詳細資訊 |
|---|
public String getUIClassID()
JComponent 中的 getUIClassIDJComponent.getUIClassID(),
UIDefaults.getUI(javax.swing.JComponent)protected Document createDefaultModel()
public void setTabSize(int size)
size - 要擴大到的字元數getTabSize()public int getTabSize()
public void setLineWrap(boolean wrap)
PropertyChange 事件("lineWrap")。此屬性預設為 false。
wrap - 指示是否應該換行getLineWrap()public boolean getLineWrap()
public void setWrapStyleWord(boolean word)
word - 指示是否應該使用單詞邊界來換行getWrapStyleWord()public boolean getWrapStyleWord()
setWrapStyleWord(boolean)
public int getLineOfOffset(int offset)
throws BadLocationException
offset - 偏移量 >= 0
BadLocationException - 如果偏移量小於 0 或大於文檔長度。public int getLineCount()
public int getLineStartOffset(int line)
throws BadLocationException
line - 要轉換的行號 >= 0
BadLocationException - 如果 line 小於 0 或大於等於文檔中所包含的行數(由 getLineCount 進行報告)。
public int getLineEndOffset(int line)
throws BadLocationException
line - 行 >= 0
BadLocationException - 如果 line 小於 0 或大於等於文檔所包含的行數(由 getLineCount 報告)。
public void insert(String str,
int pos)
雖然大多數 Swing 方法不是執行緒安全的,但此方法是執行緒安全的。有關更多資訊,請參閱 How to Use Threads。
str - 要插入的文本pos - 插入的位置 >= 0
IllegalArgumentException - 如果 pos 在模型中是一個無效的位置replaceRange(java.lang.String, int, int)public void append(String str)
雖然大多數 Swing 方法不是執行緒安全的,但此方法是執行緒安全的。有關更多資訊,請參閱 How to Use Threads。
str - 要插入的文本insert(java.lang.String, int)
public void replaceRange(String str,
int start,
int end)
雖然大多數 Swing 方法不是執行緒安全的,但此方法是執行緒安全的。有關更多資訊,請參閱 How to Use Threads。
str - 要用來替換的文本start - 起始位置 >= 0end - 結尾位置 >= start
IllegalArgumentException - 如果模型中的部分範圍是無效的位置insert(java.lang.String, int),
replaceRange(java.lang.String, int, int)public int getRows()
public void setRows(int rows)
rows - 行數 >= 0
IllegalArgumentException - 如果 rows 小於 0getRows()protected int getRowHeight()
public int getColumns()
public void setColumns(int columns)
columns - 列數 >= 0
IllegalArgumentException - 如果列小於 0getColumns()protected int getColumnWidth()
public Dimension getPreferredSize()
JComponent 中的 getPreferredSizeJComponent.setPreferredSize(java.awt.Dimension),
ComponentUIpublic void setFont(Font f)
JComponent 中的 setFontf - 要使用的當前字體Component.getFont()protected String paramString()
null。
JTextComponent 中的 paramStringpublic boolean getScrollableTracksViewportWidth()
Scrollable 中的 getScrollableTracksViewportWidthJTextComponent 中的 getScrollableTracksViewportWidthpublic Dimension getPreferredScrollableViewportSize()
Scrollable 中的 getPreferredScrollableViewportSizeJTextComponent 中的 getPreferredScrollableViewportSizeJComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect,
int orientation,
int direction)
getRowHeight 和 getColumnWidth 方法返回的值。
使用者每次請求一個單元滾動時,滾動容器(例如 JScrollPane)都將使用此方法。
Scrollable 中的 getScrollableUnitIncrementJTextComponent 中的 getScrollableUnitIncrementvisibleRect - viewport 中可見的視圖區域orientation - 或者是 SwingConstants.VERTICAL 或者是 SwingConstants.HORIZONTAL.direction - 小於 0 時為向左/上滾動,大於 0 時為向右/下滾動。
IllegalArgumentException - 如果方向無效JScrollBar.setUnitIncrement(int),
getRowHeight(),
getColumnWidth()public AccessibleContext getAccessibleContext()
Accessible 中的 getAccessibleContextJTextComponent 中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一個類別 下一個類別 | 框架 無框架 | |||||||||
| 摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 | |||||||||
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。