|
JavaTM 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 は、行を折り返すかどうかを制御する行折り返しのバウンドプロパティーを持ちます。デフォルトでは、行折り返しプロパティーは 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 - 表示されるテキストまたは 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 - 行が 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 内の 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 - ビューポート内の可視のビュー領域orientation - SwingConstants.VERTICAL または
SwingConstants.HORIZONTALdirection - 上または左にスクロールする場合は 0 より小さい値、
下または右にスクロールする場合はゼロより大きい値
IllegalArgumentException - 方向が無効な場合JScrollBar.setUnitIncrement(int),
getRowHeight(),
getColumnWidth()public AccessibleContext getAccessibleContext()
Accessible 内の getAccessibleContextJTextComponent 内の getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。