|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.text.JTextComponent | +--javax.swing.JTextArea
TextArea
は、プレーンテキストを表示する複数行の領域です。この処理を適切に行う 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);
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JTextArea
のキーの割り当てを参照してください。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降は、java.beans
パッケージにすべての JavaBeansTM の長期記憶がサポートされます。XMLEncoder
を参照してください。
JTextPane
,
JEditorPane
入れ子クラスの概要 | |
protected class |
JTextArea.AccessibleJTextArea
このクラスは JTextArea クラス用のユーザ補助機能のサポートを実装しています。 |
クラス javax.swing.text.JTextComponent から継承した入れ子クラス |
JTextComponent.KeyBinding |
クラス javax.swing.JComponent から継承した入れ子クラス |
|
クラス java.awt.Container から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
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)
論理行または列を表示するコンポーネントは、方向の値に基づいて、新しい行または列を完全に表示するスクロール増分値を計算します。 |
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
- オフセットがゼロより小さい場合、またはドキュメントの長さより大きい場合public int getLineCount()
public int getLineStartOffset(int line) throws BadLocationException
line
- 変換対象の行番号 >= 0
BadLocationException
- 行がゼロより小さい場合、またはドキュメント内の行数 (getLineCount によって報告される) より大きいか等しい場合public int getLineEndOffset(int line) throws BadLocationException
line
- 行 >= 0
BadLocationException
- 行がゼロより小さい場合、またはドキュメント内の行数 (getLineCount によって報告される) より大きいか等しい場合public void insert(String str, int pos)
このメソッドはスレッドに対して安全ですが、ほとんどの Swing メソッドは違います。詳細は、「Threads and Swing」を参照してください。
str
- 挿入するテキストpos
- 挿入位置 >= 0
IllegalArgumentException
- pos がモデル内の無効な位置の場合TextComponent.setText(java.lang.String)
,
replaceRange(java.lang.String, int, int)
public void append(String str)
このメソッドはスレッドに対して安全ですが、ほとんどの Swing メソッドは違います。詳細は、「Threads and Swing」を参照してください。
str
- 挿入するテキストinsert(java.lang.String, int)
public void replaceRange(String str, int start, int end)
このメソッドはスレッドに対して安全ですが、ほとんどの Swing メソッドは違います。詳細は、「Threads and Swing」を参照してください。
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 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.