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 |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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, validateprotected transient TextListener textListener
public void enableInputMethods(boolean enable)
enableInputMethods、クラス: Componentenable - 有効にするには true、無効にするには falseComponent.processKeyEvent(java.awt.event.KeyEvent)public InputMethodRequests getInputMethodRequests()
ComponentInputMethodRequests インスタンスを返すには、このメソッドをオーバーライドする必要があります。同時に、インプットメソッドイベントを処理する必要もあります。getInputMethodRequests、クラス: ComponentnullComponent.addInputMethodListener(java.awt.event.InputMethodListener)public void addNotify()
addNotify、クラス: ComponentremoveNotify()public void removeNotify()
TextComponent のピアを削除します。ピアを使用すると、TextComponent の機能を変更せずに外観を変更することができます。removeNotify、クラス: ComponentComponent.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、クラス: ComponentsetBackground(Color)public void setBackground(Color c)
setBackground、クラス: Componentc - このテキストコンポーネントの色になる色。このパラメータが 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(), TextListenerpublic void removeTextListener(TextListener l)
l が null である場合、例外はスローされず、何も処理は行われません。
AWT スレッドモデルの詳細は、「AWT スレッドの問題」を参照してください。
l - テキストリスナーaddTextListener(java.awt.event.TextListener), getTextListeners(), TextListenerpublic 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、クラス: ComponentlistenerType - 要求されるリスナーの型。次の下位インタフェースを指定: java.util.EventListenerFooListener として登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合getTextListeners()protected void processEvent(AWTEvent e)
TextEvent である場合、processTextEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent を呼び出します。
イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
processEvent、クラス: Componente - イベント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、クラス: Componentpublic AccessibleContext getAccessibleContext()
getAccessibleContext、インタフェース: AccessiblegetAccessibleContext、クラス: Component バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.