TextComponent (Java 2 プラットフォーム SE v1.4.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.awt
クラス TextComponent

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.TextComponent

すべての実装インタフェース:: Accessible, ImageObserver, MenuContainer, Serializable

直系の既知のサブクラス:: TextArea, TextField

public class TextComponent
extends Component
implements Accessible

TextComponent クラスは、テキストの編集を可能にするすべてのコンポーネントのスーパークラスです。

テキストコンポーネントはテキストの文字列を具体的に表現します。TextComponent クラスは、このテキストが編集可能であるかどうかを判定するメソッドセットを定義します。コンポーネントが編集可能である場合は、テキスト挿入キャレットをサポートする別のメソッドセットも定義します。

また、このクラスは、テキストの現在の選択範囲を保持するために使用されるメソッドも定義します。コンポーネントのテキストの部分テキストであるテキストの選択範囲は、編集操作の対象となります。テキストの選択範囲は、選択テキストとも呼ばれます。

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

入れ子クラスの概要

protected class TextComponent.AccessibleAWTTextComponent
          このクラスは TextComponent クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Component から継承した入れ子クラス

Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

protected TextListener 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

メソッドの概要

void addNotify()
          ネイティブスクリーンリソースに接続して、この Component を表示可能にします。

void addTextListener(TextListener l)
          このテキストコンポーネントからテキストイベントを受け取るために、指定されたテキストイベントリスナーを追加します。

void enableInputMethods(boolean enable)
          このコンポーネントのインプットメソッドサポートを使用可能または使用不可能にします。

AccessibleContext getAccessibleContext()
          この TextComponent に関連した AccessibleContext を返します。

Color getBackground()
          このテキストコンポーネントのバックグラウンドカラーを返します。

int getCaretPosition()
          このテキストコンポーネントのテキスト挿入キャレットの位置を返します。

EventListener[] getListeners(Class listenerType)
          この TextComponent に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。

String getSelectedText()
          このテキストコンポーネントによって表示されるテキストから選択テキストを返します。

int getSelectionEnd()
          このテキストコンポーネントの選択テキストの終点を返します。

int getSelectionStart()
          このテキストコンポーネントの選択テキストの始点を返します。

String getText()
          このテキストコンポーネントによって表示されるテキストを返します。

TextListener[] getTextListeners()
          このテキストコンポーネントに登録されたすべてのテキストリスナーの配列を返します。

boolean isEditable()
          このテキストコンポーネントが編集可能であるかどうかを示します。

protected String paramString()
          この TextComponent の状態を表す文字列を返します。

protected void processEvent(AWTEvent e)
          このテキストコンポーネントのイベントを処理します。

protected void processTextEvent(TextEvent e)
          このテキストコンポーネントで発生するアクションイベントを、登録された TextListener オブジェクトにディスパッチすることにより、アクションイベントを処理します。

void removeNotify()
          TextComponent のピアを削除します。

void removeTextListener(TextListener l)
          以降このテキストコンポーネントからテキストイベントを受け取らないように、指定されたテキストイベントリスナーを削除します。

void select(int selectionStart, int selectionEnd)
          指定された始点と終点の間にあるテキストを選択します。

void selectAll()
          このテキストコンポーネント内のすべてのテキストを選択します。

void setBackground(Color c)
          このテキストコンポーネントのバックグラウンドカラーを設定します。

void setCaretPosition(int position)
          このテキストコンポーネントにテキスト挿入キャレットの位置を設定します。

void setEditable(boolean b)
          このテキストコンポーネントが編集可能かどうかを指定するフラグを設定します。

void setSelectionEnd(int selectionEnd)
          このテキストコンポーネントの選択範囲の終点を、指定された位置に設定します。

void setSelectionStart(int selectionStart)
          このテキストコンポーネントの選択範囲の始点を、指定された位置に設定します。

void setText(String t)
          このテキストコンポーネントで表示されるテキストを、指定されたテキストに設定します。

クラス 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, getAlignmentX, getAlignmentY, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, 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, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, 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, setName, 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

フィールドの詳細

textListener

protected transient TextListener textListener

メソッドの詳細

enableInputMethods

public void enableInputMethods(boolean enable)

クラス Component の記述:

このコンポーネントのインプットメソッドサポートを使用可能または使用不可能にします。インプットメソッドサポートが使用可能で、コンポーネントがキーイベントも処理する場合、入力イベントは現在のインプットメソッドに提供され、そのコンポーネントによってだけ処理されるか、インプットメソッドが使用しなければ、そのリスナーに送られます。デフォルトでは、インプットメソッドサポートは使用可能です。

オーバーライド:: クラス Component 内の enableInputMethods

パラメータ:: enable - 使用可能にするには true、使用不可能にするには false
関連項目:: Component.processKeyEvent(java.awt.event.KeyEvent)

addNotify

public void addNotify()

ネイティブスクリーンリソースに接続して、この Component を表示可能にします。このメソッドは、ツールキットによって内部で呼び出されます。プログラムから直接呼び出すことはできません。

オーバーライド:: クラス Component 内の addNotify

関連項目:: removeNotify()

removeNotify

public void removeNotify()

TextComponent のピアを削除します。ピアは、TextComponent の機能を変えずに外観を変更することができます。

オーバーライド:: クラス Component 内の removeNotify

関連項目:: Component.isDisplayable(), Component.addNotify()

setText

public void setText(String t)

このテキストコンポーネントで表示されるテキストを、指定されたテキストに設定します。

パラメータ:: t - 新しいテキスト。このパラメータが null の場合、テキストは空の文字列 "" に設定される
関連項目:: getText()

getText

public String getText()

このテキストコンポーネントによって表示されるテキストを返します。

関連項目:: setText(java.lang.String)

getSelectedText

public String getSelectedText()

このテキストコンポーネントによって表示されるテキストから選択テキストを返します。

戻り値:: このテキストコンポーネントの選択テキスト
関連項目:: select(int, int)

isEditable

public boolean isEditable()

このテキストコンポーネントが編集可能であるかどうかを示します。

戻り値:: このテキストコンポーネントが編集可能である場合は true、そうでない場合は false
導入されたバージョン:: JDK1.0
関連項目:: setEditable(boolean)

setEditable

public void setEditable(boolean b)

このテキストコンポーネントが編集可能かどうかを指定するフラグを設定します。

フラグが true に設定されている場合、テキストコンポーネントはユーザによる編集が可能になります。フラグが false に設定されている場合、ユーザはこのテキストコンポーネントのテキストを変更できません。デフォルトで、編集不可能なテキストコンポーネントは SystemColor.control のバックグラウンドカラーを持ちます。このデフォルトは setBackground の呼び出しによってオーバーライドできます。

パラメータ:: b - このテキストコンポーネントがユーザにより編集可能かどうかを示すフラグ
導入されたバージョン:: JDK1.0
関連項目:: isEditable()

getBackground

public Color getBackground()

このテキストコンポーネントのバックグラウンドカラーを返します。デフォルトで、編集不可能なテキストコンポーネントは SystemColor.control のバックグラウンドカラーを持ちます。このデフォルトは setBackground の呼び出しによってオーバーライドできます。

オーバーライド:: クラス Component 内の getBackground

戻り値:: このテキストコンポーネントのバックグラウンドカラー。このテキストコンポーネントにバックグラウンドカラーがない場合は、親のバックグラウンドカラーが返される
導入されたバージョン:: JDK1.0
関連項目:: setBackground

setBackground

public void setBackground(Color c)

このテキストコンポーネントのバックグラウンドカラーを設定します。

オーバーライド:: クラス Component 内の setBackground

パラメータ:: c - このテキストコンポーネントの色になる色。このパラメータが null の場合、このテキストコンポーネントは親のバックグラウンドカラーを継承する
導入されたバージョン:: JDK1.0
関連項目:: getBackground()

getSelectionStart

public int getSelectionStart()

このテキストコンポーネントの選択テキストの始点を返します。

戻り値:: 選択テキストの始点
関連項目:: setSelectionStart(int), getSelectionEnd()

setSelectionStart

public void setSelectionStart(int selectionStart)

このテキストコンポーネントの選択範囲の始点を、指定された位置に設定します。新しい始点は現在の選択範囲の終点以前に制限されます。また、コンポーネントのテキストの先頭を示す 0 より小さい値に設定することはできません。呼び出し側が指定した selectionStart の値が境界外である場合でも、このメソッドは、失敗することなく、暗黙的にこれらの制約を適用します。

パラメータ:: selectionStart - 選択テキストの始点
導入されたバージョン:: JDK1.1
関連項目:: getSelectionStart(), setSelectionEnd(int)

getSelectionEnd

public int getSelectionEnd()

このテキストコンポーネントの選択テキストの終点を返します。

戻り値:: 選択テキストの終点
関連項目:: setSelectionEnd(int), getSelectionStart()

setSelectionEnd

public void setSelectionEnd(int selectionEnd)

このテキストコンポーネントの選択範囲の終点を、指定された位置に設定します。新しい終点は現在の選択範囲の始点以後に制限されます。また、コンポーネントのテキストの末尾を越える値に設定することはできません。呼び出し側が指定した selectionEnd の値が境界外である場合でも、このメソッドは、失敗することなく、暗黙的にこれらの制約を適用します。

パラメータ:: selectionEnd - 選択テキストの終点
導入されたバージョン:: JDK1.1
関連項目:: getSelectionEnd(), setSelectionStart(int)

select

public void select(int selectionStart,
                   int selectionEnd)

指定された始点と終点の間にあるテキストを選択します。

このメソッドは選択テキストの始点と終点を設定します。始点はゼロ以上でなければならないという制約が適用されます。終点は始点と同じか、それより大きくなければならず、またテキストコンポーネントのテキストの長さに等しいか、それより小さくなければなりません。文字の位置は、ゼロから始まるインデックスで指定します。選択範囲の長さは、 endPosition - startPosition です。そのため、endPosition にある文字は選択されません。選択テキストの始点と終点が同じ場合は、すべてのテキストの選択が解除されます。

呼び出し側が一貫性のない値または境界外の値を指定した場合、メソッドはメッセージを表示せずに、これらの制約を適用します。具体的には、始点または終点がテキストの長さを超える場合、テキストと同じ長さに設定し直します。始点がゼロより小さい場合、ゼロに設定し直します。終点が始点より小さい場合、始点に設定し直します。

パラメータ:: selectionStart - 選択される最初の文字のゼロから始まるインデックス; selectionEnd - 選択されるテキストの終点を示すゼロから始まるインデックス。selectionEnd にある文字は選択されない
関連項目:: setSelectionStart(int), setSelectionEnd(int), selectAll()

selectAll

public void selectAll()

このテキストコンポーネント内のすべてのテキストを選択します。

関連項目:: select(int, int)

setCaretPosition

public void setCaretPosition(int position)

このテキストコンポーネントにテキスト挿入キャレットの位置を設定します。キャレット位置は現在の選択範囲末尾かそれより前に制約されます。呼び出し側がコンポーネントのテキストの終点より大きな値を position に指定した場合、キャレット位置はコンポーネントのテキストの終点に設定されます。これはメッセージの表示なしで行われます。キャレット位置はまた、コンポーネントのテキストの始点であるゼロより小さく設定することはできません。呼び出し側がゼロより小さい値を position に指定した場合、IllegalArgumentException がスローされます。

パラメータ:: position - テキスト挿入キャレットの位置
例外:: IllegalArgumentException - position に指定した値が 0 未満の場合
導入されたバージョン:: JDK1.1

getCaretPosition

public int getCaretPosition()

このテキストコンポーネントのテキスト挿入キャレットの位置を返します。

戻り値:: テキスト挿入キャレットの位置
導入されたバージョン:: JDK1.1

addTextListener

public void addTextListener(TextListener l)

このテキストコンポーネントからテキストイベントを受け取るために、指定されたテキストイベントリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: l - テキストイベントリスナー
関連項目:: removeTextListener(java.awt.event.TextListener), getTextListeners(), TextListener

removeTextListener

public void removeTextListener(TextListener l)

以降このテキストコンポーネントからテキストイベントを受け取らないように、指定されたテキストイベントリスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: l - テキストリスナー
導入されたバージョン:: JDK1.1
関連項目:: addTextListener(java.awt.event.TextListener), getTextListeners(), TextListener

getTextListeners

public TextListener[] getTextListeners()

このテキストコンポーネントに登録されたすべてのテキストリスナーの配列を返します。

戻り値:: このテキストコンポーネントのすべての TextListener、または現在テキストリスナーが登録されていない場合は空の配列
導入されたバージョン:: 1.4
関連項目:: addTextListener(java.awt.event.TextListener), removeTextListener(java.awt.event.TextListener)

getListeners

public EventListener[] getListeners(Class listenerType)

この TextComponent に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。FooListener は addFooListener メソッドを使用して登録されます。

FooListener.class などのクラスリテラルを持つ listenerType 引数を指定できます。たとえば、次のコードを使用して、そのテキストリスナーの TextComponent t を照会できます。

TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));

このようなリスナーが存在しない場合、このメソッドは空の配列を返します。

オーバーライド:: クラス Component 内の getListeners

パラメータ:: listenerType - 要求されたリスナーの型。このパラメータは java.util.EventListener から派生するインタフェースを指定する
戻り値:: このテキストコンポーネントの FooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されなかった場合は空の配列
例外:: ClassCastException - listenerType が、java.util.EventListener を実装するクラスまたはインタフェースを指定しない場合
導入されたバージョン:: 1.3
関連項目:: getTextListeners()

processEvent

protected void processEvent(AWTEvent e)

このテキストコンポーネントのイベントを処理します。イベントが TextEvent の場合、processTextEvent メソッドを起動します。その他の場合は、スーパークラスの processEvent を起動します。

イベントパラメータが null の場合、動作が指定されず例外が発生することに注意してください。

オーバーライド:: クラス Component 内の processEvent

パラメータ:: e - イベント
関連項目:: Component.processComponentEvent(java.awt.event.ComponentEvent), Component.processFocusEvent(java.awt.event.FocusEvent), Component.processKeyEvent(java.awt.event.KeyEvent), Component.processMouseEvent(java.awt.event.MouseEvent), Component.processMouseMotionEvent(java.awt.event.MouseEvent), Component.processInputMethodEvent(java.awt.event.InputMethodEvent), Component.processHierarchyEvent(java.awt.event.HierarchyEvent), Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processTextEvent

protected void processTextEvent(TextEvent e)

このテキストコンポーネントで発生するアクションイベントを、登録された TextListener オブジェクトにディスパッチすることにより、アクションイベントを処理します。

注: このメソッドは、テキストイベントがこのコンポーネントに対して有効でない場合は呼び出されません。これは次のいずれかの場合に発生します。

TextListener オブジェクトが addTextListener によって登録されている
enableEvents によってテキストイベントが使用可能になっている