|
JavaTM 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
は、行を折り返すかどうかを制御する行折り返しのバウンドプロパティーを持ちます。デフォルトでは、行折り返しプロパティーは false (折り返さない) に設定されています。
java.awt.TextArea
には、適切なサイズを指定するのに使用される rows
および columns
の 2 つのプロパティーがあります。JTextArea
はこれらのプロパティーを使って、java.awt.TextArea
で提供される機能と一致するように JScrollPane
の内部にビューポートを配置する際の適切なサイズを示します。JTextArea
には、テキストすべての表示に必要となる最適なサイズが用意されているので、ビューポートは JScrollPane
の内部で適切に機能します。rows
または columns
の値が 0 のとき、その軸に沿った最適なサイズが、同じ軸に沿ったビューポートの適切なサイズに使用されます。
java.awt.TextArea
の変更を監視するには、TextEvent
の TextListener
を追加します。JTextComponent
ベースのコンポーネントでは、DocumentEvent
経由でモデルから DocumentListeners
に変更が送られます。DocumentEvent
は、必要に応じて、変更位置と変更の種類を提供します。この部分のコードは次のようになります。
DocumentListener myListener = ??; JTextArea myArea = ??; myArea.getDocument().addDocumentListener(myListener);
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans™ の長期間の運用サポートは、java.beans
パッケージに追加されています。詳細は、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)
指定されたドキュメントモデルと、ほかの引数はすべてデフォルト (null, 0, 0) で、新しい JTextArea を構築します。 |
|
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 に組み込まれている場合はビューポートの適切なサイズを返します。 |
Dimension |
getPreferredSize()
TextArea の適切なサイズを返します。 |
protected int |
getRowHeight()
行の高さの意味を返します。 |
int |
getRows()
TextArea 内の行数を返します。 |
boolean |
getScrollableTracksViewportWidth()
ビューポートが常にこの Scrollable の幅を強制的にビューポートの幅に一致させようとする場合に true を返します。 |
int |
getScrollableUnitIncrement(Rectangle visibleRect,
int orientation,
int direction)
論理行または論理列を表示するコンポーネントは、orientation の値によって、新しい 1 行または 1 列を完全にエクスポーズするスクロール増分値を計算します。 |
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
- 行が 0 より小さい場合、 またはドキュメントに含まれる行数 (getLineCount から報告される) 以上である場合にスローされるpublic int getLineEndOffset(int line) throws BadLocationException
line
- 行 >= 0
BadLocationException
- 行が 0 より小さい場合、 またはドキュメントに含まれる行数 (getLineCount から報告される) 以上である場合にスローされるpublic void insert(String str, int pos)
このメソッドはスレッドに対して安全ですが、ほとんどの Swing メソッドは違います。詳細は、「How to Use Threads」を参照してください。
str
- 挿入するテキストpos
- 挿入位置 >= 0
IllegalArgumentException
- pos がモデル内の 無効な位置にある場合TextComponent.setText(java.lang.String)
,
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
- 行が 0 より小さい場合getRows()
protected int getRowHeight()
public int getColumns()
public void setColumns(int columns)
columns
- 列数 >= 0
IllegalArgumentException
- 列数が 0 より小さい場合getColumns()
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
- ビューポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL または SwingConstants.HORIZONTALdirection
- 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
IllegalArgumentException
- 方向が無効な場合JScrollBar.setUnitIncrement(int)
,
getRowHeight()
,
getColumnWidth()
public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JTextComponent
内の getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。