|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
java.lang.Object java.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
- 要顯示的文本,或者為 nullpublic 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
中的 getUIClassID
JComponent.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
中的 getPreferredSize
JComponent.setPreferredSize(java.awt.Dimension)
,
ComponentUI
public void setFont(Font f)
JComponent
中的 setFont
f
- 要使用的當前字體Component.getFont()
protected String paramString()
null
。
JTextComponent
中的 paramString
public boolean getScrollableTracksViewportWidth()
Scrollable
中的 getScrollableTracksViewportWidth
JTextComponent
中的 getScrollableTracksViewportWidth
public Dimension getPreferredScrollableViewportSize()
Scrollable
中的 getPreferredScrollableViewportSize
JTextComponent
中的 getPreferredScrollableViewportSize
JComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
getRowHeight
和 getColumnWidth
方法返回的值。
使用者每次請求一個單元滾動時,滾動容器(例如 JScrollPane)都將使用此方法。
Scrollable
中的 getScrollableUnitIncrement
JTextComponent
中的 getScrollableUnitIncrement
visibleRect
- viewport 中可見的視圖區域orientation
- 或者是 SwingConstants.VERTICAL 或者是 SwingConstants.HORIZONTAL.direction
- 小於 0 時為向左/上滾動,大於 0 時為向右/下滾動。
IllegalArgumentException
- 如果方向無效JScrollBar.setUnitIncrement(int)
,
getRowHeight()
,
getColumnWidth()
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
JTextComponent
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。