public class TextComponent extends Component implements Accessible
TextComponent
クラスは、一部のテキストの編集を可能にするすべてのコンポーネントのスーパー・クラスです。
テキスト・コンポーネントはテキストの文字列を具体的に表現します。TextComponent
クラスは、このテキストが編集可能であるかどうかを判定するメソッド・セットを定義します。コンポーネントが編集可能である場合は、テキスト挿入キャレットをサポートする別のメソッド・セットも定義します。
また、このクラスは、テキストの現在の選択範囲を保持するために使用されるメソッドも定義します。コンポーネントのテキストの部分テキストであるテキストの選択範囲は、編集操作の対象となります。テキストの選択範囲は、選択テキストとも呼ばれます。
修飾子と型 | クラスと説明 |
---|---|
protected class |
TextComponent.AccessibleAWTTextComponent
このクラスは
TextComponent クラスのアクセシビリティ・サポートを実装しています。 |
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
修飾子と型 | フィールドと説明 |
---|---|
protected TextListener |
textListener |
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
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()
テキスト挿入キャレットの位置を返します。
|
InputMethodRequests |
getInputMethodRequests()
このコンポーネントのインプット・メソッドからの要求をサポートするインプット・メソッド要求ハンドラを取得します。
|
<T extends EventListener> |
getListeners(Class<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)
このテキスト・コンポーネントで表示されるテキストを、指定されたテキストに設定します。
|
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, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, 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, 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, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, 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
protected transient TextListener textListener
public void enableInputMethods(boolean enable)
enableInputMethods
、クラス: Component
enable
- 有効にするにはtrue、無効にするにはfalseComponent.processKeyEvent(java.awt.event.KeyEvent)
public InputMethodRequests getInputMethodRequests()
Component
InputMethodRequests
インスタンスを返すには、このメソッドをオーバーライドする必要があります。同時に、インプット・メソッド・イベントを処理する必要もあります。getInputMethodRequests
、クラス: Component
null
Component.addInputMethodListener(java.awt.event.InputMethodListener)
public void addNotify()
addNotify
、クラス: Component
removeNotify()
public void removeNotify()
TextComponent
のピアを削除します。ピアを使用すると、TextComponent
の機能を変更せずに外観を変更することができます。removeNotify
、クラス: Component
Component.isDisplayable()
, Component.addNotify()
public void setText(String t)
t
- 新しいテキスト。このパラメータがnull
の場合、テキストは空の文字列""に設定されるgetText()
public String getText()
TextComponent
の値setText(java.lang.String)
public String getSelectedText()
select(int, int)
public boolean isEditable()
true
、そうでない場合はfalse
。setEditable(boolean)
public void setEditable(boolean b)
フラグがtrue
に設定されている場合、テキスト・コンポーネントはユーザーによる編集が可能になります。フラグがfalse
に設定されている場合、ユーザーはこのテキスト・コンポーネントのテキストを変更できません。デフォルトで、編集不可能なテキスト・コンポーネントはSystemColor.controlのバックグラウンド・カラーを持ちます。このデフォルトはsetBackgroundの呼出しによってオーバーライドできます。
b
- このテキスト・コンポーネントがユーザーにより編集可能かどうかを示すフラグ。isEditable()
public Color getBackground()
getBackground
、クラス: Component
setBackground(Color)
public void setBackground(Color c)
setBackground
、クラス: Component
c
- このテキスト・コンポーネントの色になる色。このパラメータがnullの場合、このテキスト・コンポーネントは親のバックグラウンド・カラーを継承するgetBackground()
public int getSelectionStart()
setSelectionStart(int)
, getSelectionEnd()
public void setSelectionStart(int selectionStart)
selectionStart
の値を指定した場合でも、このメソッドは暗黙のうちに、かつ失敗することなくこれらの制約を適用します。selectionStart
- 選択テキストの始点getSelectionStart()
, setSelectionEnd(int)
public int getSelectionEnd()
setSelectionEnd(int)
, getSelectionStart()
public void setSelectionEnd(int selectionEnd)
selectionEnd
の値を指定した場合でも、このメソッドは暗黙のうちに、かつ失敗することなくこれらの制約を適用します。selectionEnd
- 選択テキストの終点getSelectionEnd()
, setSelectionStart(int)
public void select(int selectionStart, int selectionEnd)
このメソッドは選択テキストの始点と終点を設定します。始点は0以上でなければならないという制約が適用されます。終点は始点と同じか、それより大きい値でなければならず、またテキスト・コンポーネントのテキストの長さに等しいか、それより短くなければいけません。文字の位置は、ゼロから始まるインデックスで指定します。選択範囲の長さは、endPosition
- startPosition
です。そのため、endPosition
にある文字は選択されません。選択テキストの始点と終点が同じ場合は、すべてのテキストの選択が解除されます。
呼出し側が一貫性のない値または境界外の値を指定した場合、メソッドはメッセージを表示せずに、これらの制約を適用します。具体的には、始点または終点がテキストの長さを超える場合、テキストと同じ長さに設定し直します。始点がゼロより小さい場合、ゼロに設定し直します。終点が始点より小さい場合、始点に設定し直します。
selectionStart
- 選択される最初の文字(char
値)のゼロから始まるインデックスselectionEnd
- 選択されるテキストの終点を示すゼロから始まるインデックス。selectionEnd
にある文字(char
値)は選択されないsetSelectionStart(int)
, setSelectionEnd(int)
, selectAll()
public void selectAll()
select(int, int)
public void setCaretPosition(int position)
TextComponent
にテキストが格納されていない場合は0)に設定され、エラーは返されません。渡された値が0より小さい場合は、IllegalArgumentException
がスローされます。position
- テキスト挿入キャレットの位置IllegalArgumentException
- position
がゼロより小さい場合public int getCaretPosition()
setCaretPosition(int)
public void addTextListener(TextListener l)
l
がnull
である場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l
- テキスト・イベント・リスナーremoveTextListener(java.awt.event.TextListener)
, getTextListeners()
, TextListener
public void removeTextListener(TextListener l)
l
がnull
である場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
l
- テキスト・リスナーaddTextListener(java.awt.event.TextListener)
, getTextListeners()
, TextListener
public TextListener[] getTextListeners()
TextListener
。テキスト・リスナーが現在登録されていない場合は、空の配列addTextListener(java.awt.event.TextListener)
, removeTextListener(java.awt.event.TextListener)
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
listenerType
- 要求されるリスナーの型。java.util.EventListener
の子孫のインタフェースを指定してくださいFooListener
として登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列ClassCastException
- listenerType
で、java.util.EventListener
を実装するクラスまたはインタフェースが指定されなかった場合getTextListeners()
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)
protected void processTextEvent(TextEvent e)
TextListener
オブジェクトにディスパッチすることによって処理します。
注: このメソッドは、テキスト・イベントがこのコンポーネントに対して有効でない場合は呼び出されません。これは次のいずれか1つが発生した場合に実行されます。
TextListener
オブジェクトがaddTextListener
を使用して登録されている
enableEvents
によってテキスト・イベントが使用可能になっている
イベント・パラメータがnull
である場合は、動作が未指定のため、例外が発生する可能性があります。
e
- テキスト・イベントComponent.enableEvents(long)
protected String paramString()
TextComponent
の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる場合があります。返される文字列は空の場合がありますが、null
にはなりません。paramString
、クラス: Component
public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: Component
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.