- すべての実装されたインタフェース:
ImageObserver
,MenuContainer
,Serializable
,Accessible
public class TextComponent extends Component implements Accessible
TextComponent
クラスは、一部のテキストの編集を可能にするすべてのコンポーネントのスーパー・クラスです。
テキスト・コンポーネントはテキストの文字列を具体的に表現します。 TextComponent
クラスは、このテキストが編集可能であるかどうかを判定するメソッド・セットを定義します。 コンポーネントが編集可能である場合は、テキスト挿入キャレットをサポートする別のメソッド・セットも定義します。
また、このクラスは、テキストの現在の選択範囲を保持するために使用されるメソッドも定義します。 コンポーネントのテキストの部分テキストであるテキストの選択範囲は、編集操作の対象となります。 テキストの選択範囲は、選択テキストとも呼ばれます。
- 導入されたバージョン:
- 1.0
- 関連項目:
- 直列化された形式
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 protected class
TextComponent.AccessibleAWTTextComponent
このクラスは、TextComponent
クラスのアクセシビリティ・サポートを実装します。クラス java.awt.Componentで宣言されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 protected TextListener
textListener
このオブジェクトからイベントを受け取るリスナーのリスト。クラス java.awt.Componentで宣言されたフィールド
accessibleContext, 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()
テキスト挿入キャレットの位置を返します。<T extends EventListener>
T[]getListeners(クラス<T> 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)
以降このテキスト・コンポーネントからテキスト・イベントを受け取らないように、指定されたテキスト・イベント・リスナーを削除します。l
がnull
の場合、例外はスローされず、何も処理は行われません。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, 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, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
フィールド詳細
-
textListener
protected transient TextListener textListenerこのオブジェクトからイベントを受け取るリスナーのリスト。
-
-
メソッドの詳細
-
enableInputMethods
public void enableInputMethods(boolean enable)このテキスト・コンポーネントのインプット・メソッド・サポートを使用可能または使用不可能にします。 インプット・メソッド・サポートが使用可能で、テキスト・コンポーネントがキー・イベントも処理する場合、入力イベントは現在のインプット・メソッドに提供され、そのコンポーネントによってだけ処理されるか、インプット・メソッドが使用しなければ、そのリスナーに送られます。 このテキスト・コンポーネントのインプット・メソッド・サポートがデフォルトで有効であるか無効であるか、またその方法は実装に依存します。- オーバーライド:
enableInputMethods
、クラス:Component
- パラメータ:
enable
- 有効にするにはtrue、無効にするにはfalse- 導入されたバージョン:
- 1.2
- 関連項目:
Component.processKeyEvent(java.awt.event.KeyEvent)
-
addNotify
public void addNotify()ネイティブ・スクリーン・リソースに接続して、このComponentを表示可能にします。 このメソッドは、ツールキットによって内部で呼び出され、プログラムから直接呼び出されることはありません。- オーバーライド:
addNotify
、クラス:Component
- 関連項目:
removeNotify()
-
removeNotify
public void removeNotify()TextComponent
のピアを削除します。 ピアを使用すると、TextComponent
の機能を変更せずに外観を変更することができます。- オーバーライド:
removeNotify
、クラス:Component
- 関連項目:
Component.isDisplayable()
,Component.addNotify()
-
setText
public void setText(String t)このテキスト・コンポーネントで表示されるテキストを、指定されたテキストに設定します。- パラメータ:
t
- 新しいテキスト。このパラメータがnull
の場合、テキストは空の文字列""に設定される- 関連項目:
getText()
-
getText
public String getText()このテキスト・コンポーネントによって表示されるテキストを返します。 デフォルトでこれは空の文字列です。- 戻り値:
- この
TextComponent
の値 - 関連項目:
setText(java.lang.String)
-
getSelectedText
public String getSelectedText()このテキスト・コンポーネントによって表示されるテキストから選択テキストを返します。- 戻り値:
- このテキスト・コンポーネントの選択テキスト
- 関連項目:
select(int, int)
-
isEditable
public boolean isEditable()このテキスト・コンポーネントが編集可能であるかどうかを示します。- 戻り値:
- このテキスト・コンポーネントが編集可能である場合は
true
、そうでない場合はfalse
。 - 導入されたバージョン:
- 1.0
- 関連項目:
setEditable(boolean)
-
setEditable
public void setEditable(boolean b)このテキスト・コンポーネントが編集可能かどうかを指定するフラグを設定します。フラグが
true
に設定されている場合、テキスト・コンポーネントはユーザーによる編集が可能になります。 フラグがfalse
に設定されている場合、ユーザーはこのテキスト・コンポーネントのテキストを変更できません。 デフォルトで、編集不可能なテキスト・コンポーネントはSystemColor.controlのバックグラウンド・カラーを持ちます。 このデフォルトはsetBackgroundの呼出しによってオーバーライドできます。- パラメータ:
b
- このテキスト・コンポーネントがユーザーにより編集可能かどうかを示すフラグ。- 導入されたバージョン:
- 1.0
- 関連項目:
isEditable()
-
getBackground
public Color getBackground()このテキスト・コンポーネントのバックグラウンド・カラーを返します。 デフォルトで、編集不可能なテキスト・コンポーネントはSystemColor.controlのバックグラウンド・カラーを持ちます。 このデフォルトはsetBackgroundの呼出しによってオーバーライドできます。- オーバーライド:
getBackground
、クラス:Component
- 戻り値:
- このテキスト・コンポーネントのバックグラウンド・カラー。 このテキスト・コンポーネントにバックグラウンド・カラーがない場合は、親のバックグラウンド・カラーが返される
- 導入されたバージョン:
- 1.0
- 関連項目:
setBackground(Color)
-
setBackground
public void setBackground(Color c)このテキスト・コンポーネントのバックグラウンド・カラーを設定します。- オーバーライド:
setBackground
、クラス:Component
- パラメータ:
c
- このテキスト・コンポーネントの色になる色。 このパラメータがnullの場合、このテキスト・コンポーネントは親のバックグラウンド・カラーを継承する- 導入されたバージョン:
- 1.0
- 関連項目:
getBackground()
-
getSelectionStart
public int getSelectionStart()このテキスト・コンポーネントの選択テキストの始点を返します。- 戻り値:
- 選択テキストの始点
- 関連項目:
setSelectionStart(int)
,getSelectionEnd()
-
setSelectionStart
public void setSelectionStart(int selectionStart)このテキスト・コンポーネントの選択範囲の始点を、指定された位置に設定します。 新しい始点は現在の選択範囲の終点以前に制限されます。 また、コンポーネントのテキストの先頭を示す0より小さい値に設定することはできません。 呼出し元が、範囲外であるselectionStart
の値を指定した場合でも、このメソッドは暗黙のうちに、かつ失敗することなくこれらの制約を適用します。- パラメータ:
selectionStart
- 選択テキストの始点- 導入されたバージョン:
- 1.1
- 関連項目:
getSelectionStart()
,setSelectionEnd(int)
-
getSelectionEnd
public int getSelectionEnd()このテキスト・コンポーネントの選択テキストの終点を返します。- 戻り値:
- 選択テキストの終点
- 関連項目:
setSelectionEnd(int)
,getSelectionStart()
-
setSelectionEnd
public void setSelectionEnd(int selectionEnd)このテキスト・コンポーネントの選択範囲の終点を、指定された位置に設定します。 新しい末尾は、現在の選択領域の先頭またはそのあとに限定されます。 また、コンポーネントのテキストの末尾を超える値に設定することはできません。 呼出し元が、範囲外であるselectionEnd
の値を指定した場合でも、このメソッドは暗黙のうちに、かつ失敗することなくこれらの制約を適用します。- パラメータ:
selectionEnd
- 選択テキストの終点- 導入されたバージョン:
- 1.1
- 関連項目:
getSelectionEnd()
,setSelectionStart(int)
-
select
public void select(int selectionStart, int selectionEnd)指定された始点と終点の間にあるテキストを選択します。このメソッドは選択テキストの始点と終点を設定します。始点は0以上でなければならないという制約が適用されます。 終点は始点と同じか、それより大きい値でなければならず、またテキスト・コンポーネントのテキストの長さに等しいか、それより短くなければいけません。 文字の位置は、ゼロから始まるインデックスで指定します。 選択範囲の長さは、
endPosition
-startPosition
です。そのため、endPosition
にある文字は選択されません。 選択テキストの始点と終点が同じ場合は、すべてのテキストの選択が解除されます。呼出し側が一貫性のない値または境界外の値を指定した場合、メソッドはメッセージを表示せずに、これらの制約を適用します。 具体的には、始点または終点がテキストの長さを超える場合、テキストと同じ長さに設定し直します。 始点がゼロより小さい場合、ゼロに設定し直します。終点が始点より小さい場合、始点に設定し直します。
- パラメータ:
selectionStart
- 選択される最初の文字(char
値)のゼロから始まるインデックスselectionEnd
- 選択されるテキストの終点を示すゼロから始まるインデックス。selectionEnd
にある文字(char
値)は選択されない- 関連項目:
setSelectionStart(int)
,setSelectionEnd(int)
,selectAll()
-
selectAll
public void selectAll()このテキスト・コンポーネント内のすべてのテキストを選択します。- 関連項目:
select(int, int)
-
setCaretPosition
public void setCaretPosition(int position)テキスト挿入キャレットの位置を設定します。 キャレット位置は0からテキストの末尾の文字までに制約されます。 渡された値がこの範囲より大きい場合、値は最後の文字(またはTextComponent
にテキストが格納されていない場合は0)に設定され、エラーは返されません。 渡された値が0より小さい場合は、IllegalArgumentException
がスローされます。- パラメータ:
position
- テキスト挿入キャレットの位置- 例外:
IllegalArgumentException
-position
がゼロより小さい場合- 導入されたバージョン:
- 1.1
-
getCaretPosition
public int getCaretPosition()テキスト挿入キャレットの位置を返します。 キャレット位置は0からテキストの末尾の文字までに制約されます。 テキストまたはキャレットが設定されていない場合、デフォルトのキャレット位置は0です。- 戻り値:
- テキスト挿入キャレットの位置
- 導入されたバージョン:
- 1.1
- 関連項目:
setCaretPosition(int)
-
addTextListener
public void addTextListener(TextListener l)このテキスト・コンポーネントからテキスト・イベントを受け取るために、指定されたテキスト・イベント・リスナーを追加します。l
がnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- テキスト・イベント・リスナー- 関連項目:
removeTextListener(java.awt.event.TextListener)
,getTextListeners()
,TextListener
-
removeTextListener
public void removeTextListener(TextListener l)以降このテキスト・コンポーネントからテキスト・イベントを受け取らないように、指定されたテキスト・イベント・リスナーを削除します。l
がnull
の場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- パラメータ:
l
- テキスト・リスナー- 導入されたバージョン:
- 1.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 <T extends EventListener> T[] getListeners(Class<T> listenerType)このTextComponent
にFooListener
として現在登録されているすべてのオブジェクトの配列を返します。FooListener
は、addFooListener
メソッドを使用して登録されます。FooListener.class
などのクラス・リテラルを使用してlistenerType
引数を指定できます。 たとえば、次のコードを使用して、TextComponent t
のテキスト・リスナーを照会できます。TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));
このようなリスナーがない場合は空の配列を返します。- オーバーライド:
getListeners
、クラス:Component
- 型パラメータ:
T
- リスナーの型- パラメータ:
listenerType
- 要求されるリスナーの型。次の下位インタフェースを指定:java.util.EventListener
- 戻り値:
- このテキスト・コンポーネントに
FooListener
として登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列 - 例外:
ClassCastException
-listenerType
で、java.util.EventListener
を実装するクラスまたはインタフェースが指定されなかった場合- 導入されたバージョン:
- 1.3
- 関連項目:
getTextListeners()
-
processEvent
protected void processEvent(AWTEvent e)このテキスト・コンポーネントのイベントを処理します。 イベントがTextEvent
である場合、processTextEvent
メソッドを呼び出します。そうでない場合は、スーパー・クラスのprocessEvent
を呼び出します。イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- オーバーライド:
processEvent
、クラス:Component
- パラメータ:
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
オブジェクトにディスパッチすることによって処理します。注: このメソッドは、テキスト・イベントがこのコンポーネントに対して有効でない場合は呼び出されません。 これは次のいずれか1つが発生した場合に実行されます。
TextListener
オブジェクトがaddTextListener
を使用して登録されているenableEvents
によってテキスト・イベントが使用可能になっている
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- テキスト・イベント- 関連項目:
Component.enableEvents(long)
-
paramString
protected String paramString()このTextComponent
の状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、null
にはできません。- オーバーライド:
paramString
、クラス:Component
- 戻り値:
- このテキスト・コンポーネントのパラメータ文字列
-
getAccessibleContext
public AccessibleContext getAccessibleContext()このTextComponentに関連付けられたAccessibleContextを取得します。 テキスト・コンポーネントの場合、AccessibleContextはAccessibleAWTTextComponentの形式を取ります。 必要に応じて新規のAccessibleAWTTextComponentインスタンスが作成されます。- 定義:
getAccessibleContext
、インタフェース:Accessible
- オーバーライド:
getAccessibleContext
、クラス:Component
- 戻り値:
- このTextComponentのAccessibleContextとして機能するAccessibleAWTTextComponent
- 導入されたバージョン:
- 1.3
-