- すべての実装されたインタフェース:
- ImageObserver,- MenuContainer,- Serializable,- Accessible
TextFieldオブジェクトは、1行のテキストの編集を可能にするテキスト・コンポーネントです。
 
 たとえば、次の図は、幅の異なる4つのテキスト・フィールドを持つフレームを示しています。 これらのテキスト・フィールドのうちの2つには、"Hello"という定義済みのテキストが表示されます。 
 
  
 
これら4つのテキスト・フィールドを生成するコードを次に示します。
 TextField tf1, tf2, tf3, tf4;
 // a blank text field
 tf1 = new TextField();
 // blank field of 20 columns
 tf2 = new TextField("", 20);
 // predefined text displayed
 tf3 = new TextField("Hello!");
 // predefined text in 30 columns
 tf4 = new TextField("Hello", 30);
 
 ユーザーがテキスト・フィールドでキーを押すたびに、1つ以上のキー・イベントがテキスト・フィールドに送られます。 KeyEventは、keyPressed、keyReleased、keyTypedという3つの型のいずれかになります。 キー・イベントのプロパティは、そのイベントがこれらの型のうちのどれになるか、およびキー・イベントに適用される修飾子やイベント発生の時間などのイベントに関する追加情報を示します。 
 
 キー・イベントは、そのコンポーネントのaddKeyListenerメソッドを使って、これらのイベントを受け取るように登録されているすべてのKeyListenerまたはKeyAdapterオブジェクトに渡されます。 (KeyAdapterオブジェクトはKeyListenerインタフェースを実装します。) 
 
 ActionEventをトリガーすることも可能です。 テキスト・フィールドでアクション・イベントが可能な場合、Returnキーを押すとイベントがトリガーされます。 
 
 TextFieldクラスのprocessEventメソッドがアクション・イベントを調べて、そのイベントをprocessActionEventに渡します。 後者のメソッドは、このテキスト・フィールドによって生成されるアクション・イベントを受け取るように登録しているすべてのActionListenerオブジェクトにそのイベントを送ります。 
- 導入されたバージョン:
- 1.0
- 関連項目:
- 
ネストされたクラスのサマリーネストされたクラス修飾子と型クラス説明protected classこのクラスは、TextFieldクラスのアクセシビリティ・サポートを実装します。クラスjava.awt.TextComponentで宣言されたネストされたクラス/インタフェースTextComponent.AccessibleAWTTextComponentクラスjava.awt.Componentで宣言されたネストされたクラス/インタフェースComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
- 
フィールドのサマリークラスjava.awt.TextComponentで宣言されたフィールド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このテキスト・フィールドからアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。voidTextFieldのピアを作成します。booleanこのテキスト・フィールドでエコー用の文字セットが設定されているかどうかを示します。このTextFieldに関連付けられたAccessibleContextを取得します。このテキスト・フィールドに登録されたすべてのアクション・リスナーの配列を返します。intこのテキスト・フィールドの列数を返します。charエコー用に使用される文字を返します。<T extends EventListener>
 T[]getListeners(Class<T> listenerType) このTextFieldにFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。このテキスト・フィールドの最小サイズを取得します。getMinimumSize(int columns) 指定された列数を持つテキスト・フィールドの最小サイズを取得します。このテキスト・フィールドの推奨サイズを返します。getPreferredSize(int columns) 指定された列数での、このテキスト・フィールドの推奨サイズを返します。非推奨。minimumSize(int columns) 非推奨。JDK Version 1.1以降は、getMinimumSize(int)に置き換えられています。protected StringこのTextFieldの状態を表す文字列を返します。非推奨。JDK Version 1.1以降は、getPreferredSize()に置き換えられています。preferredSize(int columns) 非推奨。JDK Version 1.1以降は、getPreferredSize(int)に置き換えられています。protected voidこのテキスト・フィールドで発生するアクション・イベントを、登録されているActionListenerオブジェクトにディスパッチすることによって処理します。protected voidこのテキスト・フィールドのイベントを処理します。void以降このテキスト・フィールドからアクション・イベントを受け取らないように、指定されたアクション・リスナーを削除します。voidsetColumns(int columns) このテキスト・フィールドの列数を設定します。voidsetEchoChar(char c) このテキスト・フィールドのエコー文字を設定します。voidsetEchoCharacter(char c) 非推奨。JDK Version 1.1以降は、setEchoChar(char)に置き換えられています。voidこのテキスト・コンポーネントで表示されるテキストを、指定されたテキストに設定します。クラスjava.awt.TextComponentで宣言されたメソッドaddTextListener, enableInputMethods, getBackground, getCaretPosition, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStartクラス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, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, 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
- 
コンストラクタの詳細- 
TextFieldpublic TextField() throws HeadlessException新しいテキスト・フィールドを構築します。- 例外:
- HeadlessException- GraphicsEnvironment.isHeadless()がtrueを返した場合。
- 関連項目:
 
- 
TextFieldpublic TextField(String text) throws HeadlessException 指定されたテキストで初期化された新しいテキスト・フィールドを構築します。- パラメータ:
- text- 表示されるテキスト。- textが- nullである場合は、空の文字列- ""が表示されます。- textにEOLまたはLF(あるいはその両方)の文字が含まれている場合、それぞれが空白文字に置き換えられます。
- 例外:
- HeadlessException- GraphicsEnvironment.isHeadless()がtrueを返した場合。
- 関連項目:
 
- 
TextFieldpublic TextField(int columns) throws HeadlessException 指定された列数で新しい空のテキスト・フィールドを構築します。 列幅は、プラットフォームにより異なり、およそ平均文字幅になります。- パラメータ:
- columns- 列の数。- columnsが- 0より小さい場合、- columnsは- 0に設定されます。
- 例外:
- HeadlessException- GraphicsEnvironment.isHeadless()がtrueを返した場合。
- 関連項目:
 
- 
TextFieldpublic TextField(String text, int columns) throws HeadlessException 指定されたテキストが表示されるように初期化され、指定された列数を表示できる幅の新しいテキスト・フィールドを構築します。 列幅は、プラットフォームにより異なり、およそ平均文字幅になります。- パラメータ:
- text- 表示されるテキスト。- textが- nullである場合は、空の文字列- ""が表示されます。- textにEOLまたはLF(あるいはその両方)の文字が含まれている場合、それぞれが空白文字に置き換えられます。
- columns- 列の数。- columnsが- 0より小さい場合、- columnsは- 0に設定されます。
- 例外:
- HeadlessException- GraphicsEnvironment.isHeadless()がtrueを返した場合。
- 関連項目:
 
 
- 
- 
メソッドの詳細- 
addNotifypublic void addNotify()TextFieldのピアを作成します。 ピアを使うことにより、機能を変更せずにTextFieldの外見を変更することができます。- オーバーライド:
- addNotify、クラス- TextComponent
- 関連項目:
 
- 
getEchoCharpublic char getEchoChar()エコー用に使用される文字を返します。エコー文字は、パスワード入力用テキスト・フィールドなど、ユーザー入力が画面に表示されてはならないテキスト・フィールドで使用されます。 echoChar=0の場合、ユーザーが入力したまま画面に表示されます。Javaプラットフォーム実装では、エコー文字の空でない限定的なセットだけをサポートしている場合があります。 この関数は、もともとsetEchoChar()で要求されたエコー文字を返します。 TextField実装によって実際に使用されるエコー文字は、異なる場合があります。 - 戻り値:
- このテキスト・フィールドのエコー文字
- 関連項目:
 
- 
setEchoCharpublic void setEchoChar(char c) このテキスト・フィールドのエコー文字を設定します。エコー文字は、パスワード入力用テキスト・フィールドなど、ユーザー入力が画面に表示されてはならないテキスト・フィールドで使用されます。 echoChar=0に設定すると、ユーザー入力をふたたび画面に表示できます。Javaプラットフォーム実装では、エコー文字の空でない限定的なセットだけをサポートしている場合があります。 サポートされていないエコー文字を設定しようとすると、代わりにデフォルトのエコー文字が使用されます。 それ以降のgetEchoChar()の呼出しは、もともと要求されていたエコー文字を返します。 これは、TextField実装で実際に使用されるエコー文字と同一である場合も、同一でない場合もあります。 - パラメータ:
- c- このテキスト・フィールドのエコー文字。
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
setEchoCharacter@Deprecated public void setEchoCharacter(char c) 非推奨。JDK Version 1.1以降は、setEchoChar(char)に置き換えられています。保護された入力の表示時にエコーされる文字を設定します。- パラメータ:
- c- このテキスト・フィールドのエコー文字
 
- 
setTextpublic void setText(String t) このテキスト・コンポーネントで表示されるテキストを、指定されたテキストに設定します。- オーバーライド:
- setText、クラス- TextComponent
- パラメータ:
- t- 新しいテキスト。- tが- nullの場合、空の文字列- ""が表示されます。- tにEOLまたはLF(あるいはその両方)の文字が含まれている場合、それぞれが空白文字に置き換えられます。
- 関連項目:
 
- 
echoCharIsSetpublic boolean echoCharIsSet()このテキスト・フィールドでエコー用の文字セットが設定されているかどうかを示します。エコー文字は、パスワード入力用テキスト・フィールドなど、ユーザー入力が画面に表示されてはならないテキスト・フィールドで使用されます。 - 戻り値:
- このテキスト・フィールドにエコー用の文字セットが設定されている場合はtrue、そうでない場合はfalse。
- 関連項目:
 
- 
getColumnspublic int getColumns()このテキスト・フィールドの列数を返します。 列幅は、プラットフォームにより異なり、およそ平均文字幅になります。- 戻り値:
- 列数
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
setColumnspublic void setColumns(int columns) このテキスト・フィールドの列数を設定します。 列幅は、プラットフォームにより異なり、およそ平均文字幅になります。- パラメータ:
- columns- 列の数。
- 例外:
- IllegalArgumentException-- columnsに指定された値が- 0より小さい場合。
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
getPreferredSizepublic Dimension getPreferredSize(int columns) 指定された列数での、このテキスト・フィールドの推奨サイズを返します。- パラメータ:
- columns- このテキスト・フィールド内の列の数。
- 戻り値:
- このテキスト・フィールドを表示するために適した寸法
- 導入されたバージョン:
- 1.1
 
- 
preferredSize@Deprecated public Dimension preferredSize(int columns) 非推奨。JDK Version 1.1以降は、getPreferredSize(int)に置き換えられています。指定された列数を持つこのテキスト・フィールドの優先サイズを返します。- パラメータ:
- columns- 列の数
- 戻り値:
- テキスト・フィールドの優先サイズ
 
- 
getPreferredSizepublic Dimension getPreferredSize()このテキスト・フィールドの推奨サイズを返します。- オーバーライド:
- getPreferredSize、クラス- Component
- 戻り値:
- このテキスト・フィールドを表示するために適した寸法
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
preferredSize@Deprecated public Dimension preferredSize()非推奨。JDK Version 1.1以降は、getPreferredSize()に置き換えられています。次のクラスからコピーされた説明:Componentコンポーネントの優先サイズを返します。- オーバーライド:
- preferredSize、クラス- Component
- 戻り値:
- コンポーネントの優先サイズ
 
- 
getMinimumSizepublic Dimension getMinimumSize(int columns) 指定された列数を持つテキスト・フィールドの最小サイズを取得します。- パラメータ:
- columns- このテキスト・フィールド内の列の数。
- 戻り値:
- このテキスト・フィールドの最小サイズ
- 導入されたバージョン:
- 1.1
 
- 
minimumSize@Deprecated public Dimension minimumSize(int columns) 非推奨。JDK Version 1.1以降は、getMinimumSize(int)に置き換えられています。指定した数の列を持つテキスト・フィールドの最小ディメンションを返します。- パラメータ:
- columns- 列の数
- 戻り値:
- このテキスト・フィールドの最小サイズ
 
- 
getMinimumSizepublic Dimension getMinimumSize()このテキスト・フィールドの最小サイズを取得します。- オーバーライド:
- getMinimumSize、クラス- Component
- 戻り値:
- このテキスト・フィールドを表示するための最小の寸法
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
minimumSize@Deprecated public Dimension minimumSize()非推奨。JDK Version 1.1以降は、getMinimumSize()に置き換えられています。次のクラスからコピーされた説明:Componentこのコンポーネントの最小サイズを返します。- オーバーライド:
- minimumSize、クラス- Component
- 戻り値:
- このコンポーネントの最小サイズ
 
- 
addActionListenerpublic void addActionListener(ActionListener l) このテキスト・フィールドからアクション・イベントを受け取るために、指定されたアクション・リスナーを追加します。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。 - パラメータ:
- l- アクション・リスナー。
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
removeActionListenerpublic void removeActionListener(ActionListener l) 以降このテキスト・フィールドからアクション・イベントを受け取らないように、指定されたアクション・リスナーを削除します。 lがnullの場合、例外はスローされず、処理も実行されません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。 - パラメータ:
- l- アクション・リスナー。
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
getActionListenerspublic ActionListener[] getActionListeners()このテキスト・フィールドに登録されたすべてのアクション・リスナーの配列を返します。- 戻り値:
- このテキスト・フィールドのすべてのActionListener。アクション・リスナーが現在登録されていない場合は空の配列
- 導入されたバージョン:
- 1.4
- 関連項目:
 
- 
getListenerspublic <T extends EventListener> T[] getListeners(Class<T> listenerType) このTextFieldにFooListenerとして現在登録されているすべてのオブジェクトの配列を返します。FooListenerは、addFooListenerメソッドを使用して登録されます。FooListener.classなどのクラス・リテラルを使用してlistenerType引数を指定できます。 たとえば、次のコードを使用して、アクション・リスナーのTextField tを問い合せることができます:ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class)); このようなリスナーがない場合は空の配列を返します。- オーバーライド:
- getListeners、クラス- TextComponent
- 型パラメータ:
- T- リスナーの型
- パラメータ:
- listenerType- 要求されるリスナーの型;- java.util.EventListenerの下位インタフェースを指定
- 戻り値:
- このテキスト・フィールドにFooListenerとして登録されているすべてのオブジェクトの配列。そのようなリスナーが登録されていない場合は空の配列
- 例外:
- ClassCastException-- listenerTypeで、- java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった場合
- 導入されたバージョン:
- 1.3
- 関連項目:
 
- 
processEventprotected void processEvent(AWTEvent e) このテキスト・フィールドのイベントを処理します。 イベントがActionEventのインスタンスである場合は、processActionEventメソッドを呼び出します。 それ以外の場合は、スーパー・クラスのprocessEventを呼び出します。イベント・パラメータが nullである場合は、動作が未指定のため、例外が発生する可能性があります。- オーバーライド:
- processEvent、クラス- TextComponent
- パラメータ:
- e- イベント
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
processActionEventprotected void processActionEvent(ActionEvent e) このテキスト・フィールドで発生するアクション・イベントを、登録されているActionListenerオブジェクトにディスパッチすることによって処理します。このコンポーネントに対してアクション・イベントが使用可能でないかぎり、このメソッドは呼び出されません。 アクション・イベントは、次のどちらかの場合に使用可能になります。 - ActionListenerオブジェクトが- addActionListenerによって登録されている。
- enableEventsによってアクション・イベントが使用可能になっている。
 イベント・パラメータが nullである場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
- e- アクション・イベント
- 導入されたバージョン:
- 1.1
- 関連項目:
 
- 
paramStringprotected String paramString()このTextFieldの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。- オーバーライド:
- paramString、クラス- TextComponent
- 戻り値:
- このテキスト・フィールドのパラメータ文字列
 
- 
getAccessibleContextpublic AccessibleContext getAccessibleContext()このTextFieldに関連付けられたAccessibleContextを取得します。 テキスト・フィールドの場合、AccessibleContextはAccessibleAWTTextFieldの形式を取ります。 新規のAccessibleAWTTextFieldインスタンスが必要に応じて作成されます。- 定義:
- getAccessibleContext、インタフェース- Accessible
- オーバーライド:
- getAccessibleContext、クラス- TextComponent
- 戻り値:
- このTextFieldのAccessibleContextとして機能するAccessibleAWTTextField
- 導入されたバージョン:
- 1.3
 
 
- 
getMinimumSize()に置き換えられています。