java.awt
クラス TextArea

java.lang.Object
  java.awt.Component
      java.awt.TextComponent
          java.awt.TextArea

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

public class TextArea
extends TextComponent

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

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

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

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

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

入れ子のクラスの概要

protected class

TextArea.AccessibleAWTTextArea このクラスは TextArea クラス用のアクセシビリティーのサポートを実装しています。

クラス java.awt.TextComponent から継承された入れ子のクラス/インタフェース

TextComponent.AccessibleAWTTextComponent

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

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

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタの概要

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 version 1.1 以降は、 append(String) に置き換えられました。
AccessibleContext	getAccessibleContext() この TextArea に関連付けられた AccessibleContext を返します。
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 version 1.1 以降は、 insert(String, int) に置き換えられました。
Dimension	minimumSize() 推奨されていません。 JDK version 1.1 以降は、 getMinimumSize() に置き換えられました。
Dimension	minimumSize(int rows, int columns) 推奨されていません。 JDK version 1.1 以降は、 getMinimumSize(int, int) に置き換えられました。
protected String	paramString() この TextArea の状態を表す文字列を返します。
Dimension	preferredSize() 推奨されていません。 JDK version 1.1 以降は、 getPreferredSize() に置き換えられました。
Dimension	preferredSize(int rows, int columns) 推奨されていません。 JDK version 1.1 以降は、 getPreferredSize(int, int) に置き換えられました。
void	replaceRange(String str, int start, int end) 指定された始点と終点の間のテキストを、指定されたテキストに置き換えます。
void	replaceText(String str, int start, int end) 推奨されていません。 JDK version 1.1 以降は、 replaceRange(String, int, int) に置き換えられました。
void	setColumns(int columns) このテキスト領域の列数を設定します。
void	setRows(int rows) このテキスト領域の行数を設定します。

クラス java.awt.TextComponent から継承されたメソッド

addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getListeners, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText

クラス java.awt.Component から継承されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, 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()
         throws HeadlessException

空の文字列で新しいテキスト領域を構築します。このテキスト領域は、スクロールバーの可視性が SCROLLBARS_BOTH の設定で作成されます。 このため、このテキスト領域では、垂直と水平の両方のスクロールバーが可視になります。

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text)
         throws HeadlessException

指定されたテキストで新しいテキスト領域を構築します。このテキスト領域は、スクロールバーの可視性が SCROLLBARS_BOTH の設定で作成されます。 このため、このテキスト領域では、垂直と水平の両方のスクロールバーが可視になります。

パラメータ:

text - 表示されるテキスト。 text が null の場合は、 空の文字列 "" が表示される

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException

指定された行数と列数と空のテキスト文字列を持つ新しいテキスト領域を構築します。列幅は、プラットフォームにより異なり、およそ平均文字幅になります。テキスト領域は、スクロールバーの可視性が SCROLLBARS_BOTH の設定で作成されます。 このため、このテキスト領域では、垂直と水平の両方のスクロールバーが可視になります。

パラメータ:

rows - 行数

columns - 列数

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns)
         throws HeadlessException

指定された行数と列数を持つ空のテキスト領域を、指定されたテキストで構築します。列幅は、プラットフォームにより異なり、およそ平均文字幅になります。テキスト領域は、スクロールバーの可視性が SCROLLBARS_BOTH の設定で作成されます。 このため、このテキスト領域では、垂直と水平の両方のスクロールバーが可視になります。

パラメータ:

text - 表示されるテキスト。 text が null の場合は、 空の文字列 "" が表示される

rows - 行数

columns - 列数

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns,
                int scrollbars)
         throws HeadlessException

指定された行数および列数の、指定されたテキストが表示される新しいテキスト領域を、指定されたスクロールバーの可視性で構築します。すべての TextArea コンストラクタはこのコンストラクタに従います。

TextArea は scrollbars の引数の値として提供される次のようないくつかの定数を定義します。

• SCROLLBARS_BOTH
• SCROLLBARS_VERTICAL_ONLY
• SCROLLBARS_HORIZONTAL_ONLY
• SCROLLBARS_NONE

scrollbars のその他の引数は無効となり、そのため SCROLLBARS_BOTH のデフォルト値と同じスクロールバーの可視性がこのテキスト領域で作成されます。

パラメータ:

text - 表示されるテキスト。 text が null の場合は、 空の文字列 "" が表示される

rows - 行数。 rows が 0 より小さい場合、 rows は 0 に設定される

columns - 列数。 columns が 0 より小さい場合、 columns は 0 に設定される

scrollbars - テキスト領域を表示するために どのスクロールバーが作成されるかを指定する定数

例外:

HeadlessException - GraphicsEnvironment.isHeadless が true を返す場合

導入されたバージョン:

JDK1.1

関連項目:

GraphicsEnvironment.isHeadless()

メソッドの詳細

addNotify

public void addNotify()

TextArea のピアを作成します。ピアは TextArea の機能を変更せずに外観を変更できます。

オーバーライド:

クラス TextComponent 内の addNotify

関連項目:

TextComponent.removeNotify()

insert

public void insert(String str,
                   int pos)

このテキスト領域内の指定された位置に、指定されたテキストを挿入します。 　

null を渡したり、無効な整合性のないパラメータにより、特定できない動作を発生させないようにしてください。

パラメータ:

str - 挿入する null 以外の文字列

pos - 挿入する位置

導入されたバージョン:

JDK1.1

関連項目:

TextComponent.setText(java.lang.String), replaceRange(java.lang.String, int, int), append(java.lang.String)

insertText

@Deprecated
public void insertText(String str,
                                  int pos)

推奨されていません。 JDK version 1.1 以降は、 insert(String, int) に置き換えられました。

append

public void append(String str)

テキスト領域の現在のテキストに、指定されたテキストを追加します。 　

null を渡したり、無効な整合性のないパラメータにより、特定できない動作を発生させないようにしてください。

パラメータ:

str - 追加する null 以外の文字列

導入されたバージョン:

JDK1.1

関連項目:

insert(java.lang.String, int)

appendText

@Deprecated
public void appendText(String str)

推奨されていません。 JDK version 1.1 以降は、 append(String) に置き換えられました。

replaceRange

public void replaceRange(String str,
                         int start,
                         int end)

指定された始点と終点の間のテキストを、指定されたテキストに置き換えます。終点のテキストは置き換えられません。始点のテキストは、始点が終点と同じ位置にない場合に置き換えられます。テキストの位置はゼロから始まります。挿入される部分文字列は、置き換えるテキストと長さが異なる場合があります。 　

null を渡したり、無効な整合性のないパラメータにより、特定できない動作を発生させないようにしてください。

パラメータ:

str - 置き換えに使用する null 以外の テキスト

start - 始点

end - 終点

導入されたバージョン:

JDK1.1

関連項目:

insert(java.lang.String, int)

replaceText

@Deprecated
public void replaceText(String str,
                                   int start,
                                   int end)

推奨されていません。 JDK version 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 - 行数

columns - 列数

戻り値:

指定された行数および列数の テキスト領域を表示するために 必要な推奨サイズ

導入されたバージョン:

JDK1.1

関連項目:

Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize(int rows,
                                          int columns)

推奨されていません。 JDK version 1.1 以降は、 getPreferredSize(int, int) に置き換えられました。

getPreferredSize

public Dimension getPreferredSize()

このテキスト領域の推奨サイズを判定します。

オーバーライド:

クラス Component 内の getPreferredSize

戻り値:

このテキスト領域に必要な推奨サイズ

導入されたバージョン:

JDK1.1

関連項目:

Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()

推奨されていません。 JDK version 1.1 以降は、 getPreferredSize() に置き換えられました。

オーバーライド:

クラス Component 内の preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows,
                                int columns)

指定された行数および列数のテキスト領域の最小サイズを判定します。

パラメータ:

rows - 行数

columns - 列数

戻り値:

指定された行数および列数の テキスト領域を表示するために 必要な最小サイズ

導入されたバージョン:

JDK1.1

関連項目:

Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows,
                                        int columns)

推奨されていません。 JDK version 1.1 以降は、 getMinimumSize(int, int) に置き換えられました。

getMinimumSize

public Dimension getMinimumSize()

このテキスト領域の最小サイズを判定します。

オーバーライド:

クラス Component 内の getMinimumSize

戻り値:

このテキスト領域に必要な推奨サイズ

導入されたバージョン:

JDK1.1

関連項目:

Component.getPreferredSize()

minimumSize

@Deprecated
public Dimension minimumSize()

推奨されていません。 JDK version 1.1 以降は、 getMinimumSize() に置き換えられました。

オーバーライド:

クラス Component 内の minimumSize

paramString

protected String paramString()

この TextArea の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

クラス TextComponent 内の paramString

戻り値:

テキスト領域のパラメータの文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

この TextArea に関連付けられた AccessibleContext を返します。テキスト領域の場合、AccessibleContext は AccessibleAWTTextArea の形式を取ります。必要に応じて、新しい AccessibleAWTTextArea インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス TextComponent 内の getAccessibleContext

戻り値:

この TextArea の AccessibleContext として機能する AccessibleAWTTextArea

導入されたバージョン:

1.3