Java プラットフォーム 1.2

java.awt
クラス TextArea

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.TextComponent
              |
              +--java.awt.TextArea
public class TextArea
extends TextComponent

TextArea オブジェクトは、テキストを表示する複数行領域です。編集可能に設定することも、読み取り専用に設定することもできます。

次の図は、テキスト領域の外観を示します。

このテキスト領域は、次のコードによって作成できます。 

 new TextArea("Hello", 5, 40);

導入されたバージョン:
JDK1.0
関連項目:
直列化された形式

フィールドの概要
static int SCROLLBARS_BOTH
          水平と垂直スクロールバーを作成し、表示します。
static int SCROLLBARS_HORIZONTAL_ONLY
          水平スクロールバーだけを作成し、表示します。
static int SCROLLBARS_NONE
          このテキスト領域のどのスクロールバーも作成しません。
static int SCROLLBARS_VERTICAL_ONLY
          垂直スクロールバーだけを作成し、表示します。
 
クラス java.awt.TextComponent から継承したフィールド
textListener
 
クラス java.awt.Component から継承したフィールド
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
コンストラクタの概要
TextArea()
          新しいテキスト領域を構築します。
TextArea(int rows, int columns)
          指定された行数と列数を持つ空のテキスト領域を構築します。
TextArea(String text)
          指定されたテキストが表示される新しいテキスト領域を構築します。
TextArea(String text, int rows, int columns)
          指定された行数および列数の、指定されたテキストが表示される新しいテキスト領域を構築します。
TextArea(String text, int rows, int columns, int scrollbars)
          指定された行数および列数の、指定されたテキストが表示される新しいテキスト領域を、指定されたスクロールバーの可視性で構築します。
 
メソッドの概要
 void addNotify()
          TextArea のピアを作成します。
 void append(String str)
          テキスト領域の現在のテキストに、指定されたテキストを追加します。
 void appendText(String str)
          推奨されません。 JDK バージョン 1.1 以降は、append(String) に置き換えられました。
 int getColumns()
          このテキスト領域の列数を取得します。
 Dimension getMinimumSize()
          このテキスト領域の最小サイズを判定します。
 Dimension getMinimumSize(int rows, int columns)
          指定された行数および列数のテキスト領域の最小サイズを判定します。
 Dimension getPreferredSize()
          このテキスト領域の推奨サイズを判定します。
 Dimension getPreferredSize(int rows, int columns)
          指定された行数および列数のテキスト領域の推奨サイズを判定します。
 int getRows()
          テキスト領域の行数を取得します。
 int getScrollbarVisibility()
          テキスト領域が使用するスクロールバーを示す値を列挙値から取得します。
 void insert(String str, int pos)
          このテキスト領域内の指定された位置に、指定されたテキストを挿入します。
 void insertText(String str, int pos)
          推奨されません。 JDK バージョン 1.1 以降は、insert(String, int) に置き換えられました。
 Dimension minimumSize()
          推奨されません。 JDK バージョン 1.1 以降は、getMinimumSize() に置き換えられました。
 Dimension minimumSize(int rows, int columns)
          推奨されません。 JDK バージョン 1.1 以降は、getMinimumSize(int, int) に置き換えられました。
protected  String paramString()
          このテキスト領域の状態を表すパラメータの文字列を返します。
 Dimension preferredSize()
          推奨されません。 JDK バージョン 1.1 以降は、getPreferredSize() に置き換えられました。
 Dimension preferredSize(int rows, int columns)
          推奨されません。 JDK バージョン 1.1 以降は、getPreferredSize(int, int) に置き換えられました。
 void replaceRange(String str, int start, int end)
          指定された始点と終点の間のテキストを、指定されたテキストに置き換えます。
 void replaceText(String str, int start, int end)
          推奨されません。 JDK バージョン 1.1 以降は、replaceRange(String, int, int) に置き換えられました。
 void setColumns(int columns)
          このテキスト領域の列数を設定します。
 void setRows(int rows)
          このテキスト領域の行数を設定します。
 
クラス java.awt.TextComponent から継承したメソッド
addTextListener, getCaretPosition, getSelectedText, getSelectionEnd, getSelectionStart, getText, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getName, getParent, getPeer, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFont, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, update, validate
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

SCROLLBARS_BOTH

public static final int SCROLLBARS_BOTH
水平と垂直スクロールバーを作成し、表示します。
導入されたバージョン:
JDK1.1

SCROLLBARS_VERTICAL_ONLY

public static final int SCROLLBARS_VERTICAL_ONLY
垂直スクロールバーだけを作成し、表示します。
導入されたバージョン:
JDK1.1

SCROLLBARS_HORIZONTAL_ONLY

public static final int SCROLLBARS_HORIZONTAL_ONLY
水平スクロールバーだけを作成し、表示します。
導入されたバージョン:
JDK1.1

SCROLLBARS_NONE

public static final int SCROLLBARS_NONE
このテキスト領域のどのスクロールバーも作成しません。
導入されたバージョン:
JDK1.1
コンストラクタの詳細

TextArea

public TextArea()
新しいテキスト領域を構築します。このテキスト領域には垂直スクロールバーおよび水平スクロールバーの両方が作成されます。

TextArea

public TextArea(String text)
指定されたテキストが表示される新しいテキスト領域を構築します。このテキスト領域には垂直スクロールバーおよび水平スクロールバーの両方が作成されます。
パラメータ:
text - 表示されるテキスト

TextArea

public TextArea(int rows,
                int columns)
指定された行数と列数を持つ空のテキスト領域を構築します。テキスト領域は、スクロールバーの可視性が SCROLLBARS_BOTH の設定で作成されます。このため、垂直と水平の両方のスクロールバーが可視になります。
パラメータ:
rows - 行数
columns - 列数

TextArea

public TextArea(String text,
                int rows,
                int columns)
指定された行数および列数の、指定されたテキストが表示される新しいテキスト領域を構築します。このテキスト領域には垂直スクロールバーおよび水平スクロールバーの両方が作成されます。
パラメータ:
text - 表示されるテキスト
rows - 行数
columns - 列数

TextArea

public TextArea(String text,
                int rows,
                int columns,
                int scrollbars)
指定された行数および列数の、指定されたテキストが表示される新しいテキスト領域を、指定されたスクロールバーの可視性で構築します。

TextArea クラスは、scrollbars 引数の値として指定できる、SCROLLBARS_BOTH、SCROLLBARS_VERTICAL_ONLY、SCROLLBARS_HORIZONTAL_ONLY、SCROLLBARS_NONE という定数を定義します。これら以外の scrollbars 引数の値は無効であり、その場合、このテキスト領域はスクロールバーの可視性が既定値の SCROLLBARS_BOTH で作成されます。

パラメータ:
text - 表示されるテキスト
rows - 行数
columns - 列数
scrollbars - テキスト領域を表示するためにどのスクロールバーが作成されるかを指定する定数
導入されたバージョン:
JDK1.1
メソッドの詳細

addNotify

public void addNotify()
TextArea のピアを作成します。ピアを使うことにより、機能性はまったく変えずに、テキスト領域の外観を修正できるようになります。
オーバーライド:
クラス Component 内の addNotify

insert

public void insert(String str,
                   int pos)
このテキスト領域内の指定された位置に、指定されたテキストを挿入します。
パラメータ:
str - 挿入されるテキスト
pos - 挿入される位置
導入されたバージョン:
JDK1.1
関連項目:
TextComponent.setText(java.lang.String), replaceRange(java.lang.String, int, int), append(java.lang.String)

insertText

public void insertText(String str,
                       int pos)
推奨されません。 JDK バージョン 1.1 以降は、insert(String, int) に置き換えられました。

append

public void append(String str)
テキスト領域の現在のテキストに、指定されたテキストを追加します。
パラメータ:
str - 追加されるテキスト
関連項目:
insert(java.lang.String, int)

appendText

public void appendText(String str)
推奨されません。 JDK バージョン 1.1 以降は、append(String) に置き換えられました。

replaceRange

public void replaceRange(String str,
                         int start,
                         int end)
指定された始点と終点の間のテキストを、指定されたテキストに置き換えます。
パラメータ:
str - 置き換えるテキスト
start - 始点
end - 終点
導入されたバージョン:
JDK1.1
関連項目:
insert(java.lang.String, int)

replaceText

public void replaceText(String str,
                        int start,
                        int end)
推奨されません。 JDK バージョン 1.1 以降は、replaceRange(String, int, int) に置き換えられました。

getRows

public int getRows()
テキスト領域の行数を取得します。
戻り値:
テキスト領域の行数
導入されたバージョン:
JDK1
関連項目:
setRows(int), getColumns()

setRows

public void setRows(int rows)
このテキスト領域の行数を設定します。
パラメータ:
rows - 行数
例外:
IllegalArgumentException - rows に指定された値が 0 より小さい場合
導入されたバージョン:
JDK1.1
関連項目:
getRows(), setColumns(int)

getColumns

public int getColumns()
このテキスト領域の列数を取得します。
戻り値:
テキスト領域の列数
関連項目:
setColumns(int), getRows()

setColumns

public void setColumns(int columns)
このテキスト領域の列数を設定します。
パラメータ:
columns - 列数
例外:
IllegalArgumentException - columns に指定された値が 0 より小さい場合
導入されたバージョン:
JDK1.1
関連項目:
getColumns(), setRows(int)

getScrollbarVisibility

public int getScrollbarVisibility()
テキスト領域が使用するスクロールバーを示す値を列挙値から取得します。

TextArea クラスは、どのスクロールバーが利用可能かを指定するために使用される 4 つの整数型定数を定義します。TextArea は、アプリケーションにスクロールバーの選択を与える 1 つのコンストラクタを持ちます。

戻り値:
どのスクロールバーを使用するかを示す整数
導入されたバージョン:
JDK1.1
関連項目:
SCROLLBARS_BOTH, SCROLLBARS_VERTICAL_ONLY, SCROLLBARS_HORIZONTAL_ONLY, SCROLLBARS_NONE, TextArea(java.lang.String, int, int, int)

getPreferredSize

public Dimension getPreferredSize(int rows,
                                  int columns)
指定された行数および列数のテキスト領域の推奨サイズを判定します。
パラメータ:
rows - 行数
cols - 列数
戻り値:
指定された行数および列数のテキスト領域を表示するために必要な推奨サイズ
導入されたバージョン:
JDK1.1
関連項目:
Component.getPreferredSize()

preferredSize

public Dimension preferredSize(int rows,
                               int columns)
推奨されません。 JDK バージョン 1.1 以降は、getPreferredSize(int, int) に置き換えられました。

getPreferredSize

public Dimension getPreferredSize()
このテキスト領域の推奨サイズを判定します。
戻り値:
このテキスト領域に必要な推奨サイズ
オーバーライド:
クラス Component 内の getPreferredSize
導入されたバージョン:
JDK1.1
関連項目:
Component.getPreferredSize()

preferredSize

public Dimension preferredSize()
推奨されません。 JDK バージョン 1.1 以降は、getPreferredSize() に置き換えられました。
オーバーライド:
クラス Component 内の preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows,
                                int columns)
指定された行数および列数のテキスト領域の最小サイズを判定します。
パラメータ:
rows - 行数
cols - 列数
戻り値:
指定された行数および列数のテキスト領域を表示するために必要な最小サイズ
導入されたバージョン:
JDK1.1
関連項目:
Component.getMinimumSize()

minimumSize

public Dimension minimumSize(int rows,
                             int columns)
推奨されません。 JDK バージョン 1.1 以降は、getMinimumSize(int, int) に置き換えられました。

getMinimumSize

public Dimension getMinimumSize()
このテキスト領域の最小サイズを判定します。
戻り値:
このテキスト領域に必要な推奨サイズ
オーバーライド:
クラス Component 内の getMinimumSize
導入されたバージョン:
JDK1.1
関連項目:
Component.getPreferredSize()

minimumSize

public Dimension minimumSize()
推奨されません。 JDK バージョン 1.1 以降は、getMinimumSize() に置き換えられました。
オーバーライド:
クラス Component 内の minimumSize

paramString

protected String paramString()
このテキスト領域の状態を表すパラメータの文字列を返します。この文字列はデバッグに使用します。
戻り値:
テキスト領域のパラメータの文字列
オーバーライド:
クラス TextComponent 内の paramString
Java プラットフォーム 1.2
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.