| 
 | 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 - 表示されるテキストまたは 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 - オフセットがゼロより小さい場合、またはドキュメントの長さより大きい場合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 内の 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 より小さく、下または右にスクロールする場合は 0 より大きい
IllegalArgumentException - 方向が無効な場合JScrollBar.setUnitIncrement(int), 
getRowHeight(), 
getColumnWidth()public AccessibleContext getAccessibleContext()
Accessible 内の getAccessibleContextJTextComponent 内の 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.