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_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.EventListenerの子孫のインタフェースを指定してくださいFooListenerとして登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列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, 2014, Oracle and/or its affiliates. All rights reserved.