|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.TextComponent | +--java.awt.TextField
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
に渡します。processActionEvent
メソッドは、このテキストフィールドが生成するアクションイベントを受け取るよう登録されているすべての ActionListener
オブジェクトにイベントを転送します。
KeyEvent
,
KeyAdapter
,
KeyListener
,
ActionEvent
,
Component.addKeyListener(java.awt.event.KeyListener)
,
processEvent(java.awt.AWTEvent)
,
processActionEvent(java.awt.event.ActionEvent)
,
addActionListener(java.awt.event.ActionListener)
,
直列化された形式入れ子クラスの概要 | |
protected class |
TextField.AccessibleAWTTextField
このクラスは TextField クラス用のユーザ補助機能のサポートを実装しています。 |
クラス java.awt.TextComponent から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
Component.BltBufferStrategy, Component.FlipBufferStrategy |
フィールドの概要 |
クラス java.awt.TextComponent から継承したフィールド |
textListener |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
TextField()
新しいテキストフィールドを構築します。 |
|
TextField(int columns)
指定された列数で新しい空のテキストフィールドを構築します。 |
|
TextField(String text)
指定されたテキストで初期化された新しいテキストフィールドを構築します。 |
|
TextField(String text,
int columns)
指定されたテキストが表示されるように初期化され、指定された列数を表示できる幅の新しいテキストフィールドを構築します。 |
メソッドの概要 | |
void |
addActionListener(ActionListener l)
このテキストフィールドのアクションイベントを受け取るために、指定されたアクションリスナーを追加します。 |
void |
addNotify()
TextField のピアを作成します。 |
boolean |
echoCharIsSet()
このテキストフィールドでエコー用の文字が設定されているかどうかを示します。 |
AccessibleContext |
getAccessibleContext()
この TextField に関連した AccessibleContext を返します。 |
ActionListener[] |
getActionListeners()
このテキストフィールドに登録されたすべてのアクションリスナーの配列を返します。 |
int |
getColumns()
このテキストフィールドの列数を返します。 |
char |
getEchoChar()
エコー用に使用される文字を返します。 |
EventListener[] |
getListeners(Class listenerType)
この TextField に FooListener として、現在登録されているすべてのオブジェクトの配列を返します。 |
Dimension |
getMinimumSize()
このテキストフィールドの最小サイズを返します。 |
Dimension |
getMinimumSize(int columns)
指定された列数での、このテキストフィールドの最小サイズを返します。 |
Dimension |
getPreferredSize()
このテキストフィールドの推奨サイズを返します。 |
Dimension |
getPreferredSize(int columns)
指定された列数での、このテキストフィールドの推奨サイズを返します。 |
Dimension |
minimumSize()
推奨されていません。 JDK バージョン 1.1 以降は、 getMinimumSize() を使用 |
Dimension |
minimumSize(int columns)
推奨されていません。 JDK バージョン 1.1 以降は、 getPreferredSize(int) を使用 |
protected String |
paramString()
この TextField の状態を表す文字列を返します。 |
Dimension |
preferredSize()
推奨されていません。 JDK バージョン 1.1 以降は、 getPreferredSize() を使用 |
Dimension |
preferredSize(int columns)
推奨されていません。 JDK バージョン 1.1 以降は、 getPreferredSize(int) を使用 |
protected void |
processActionEvent(ActionEvent e)
このテキストフィールドで発生するアクションイベントを、登録された ActionListener オブジェクトにディスパッチすることにより、このイベントを処理します。
|
protected void |
processEvent(AWTEvent e)
このテキストフィールドのイベントを処理します。 |
void |
removeActionListener(ActionListener l)
以降このテキストフィールドからアクションイベントを受け取らないように、指定されたアクションリスナーを削除します。 |
void |
setColumns(int columns)
このテキストフィールドの列数を設定します。 |
void |
setEchoChar(char c)
このテキストフィールドのエコー文字を設定します。 |
void |
setEchoCharacter(char c)
推奨されていません。 JDK バージョン 1.1 以降は、 setEchoChar(char) を使用 |
void |
setText(String t)
このテキストコンポーネントで表示されるテキストを、指定されたテキストに設定します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
public TextField() throws HeadlessException
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public TextField(String text) throws HeadlessException
text
- 表示するテキスト。text
が null
の場合は、空の文字列 ""
が表示される
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public TextField(int columns) throws HeadlessException
columns
- 列数。columns
が 0
より小さい場合、columns
は 0
に設定される
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
public TextField(String text, int columns) throws HeadlessException
text
- 表示するテキスト。text
が null
の場合は、空の文字列 ""
が表示されるcolumns
- 列数。columns
が 0
より小さい場合、columns
は 0
に設定される
HeadlessException
- GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless()
メソッドの詳細 |
public void addNotify()
TextComponent
内の addNotify
TextComponent.removeNotify()
public char getEchoChar()
エコー文字は、パスワード入力用テキストフィールドなど、ユーザ入力が画面に表示されてはならないテキストフィールドで使用されます。echoChar
= 0
の場合、ユーザが入力したまま画面に表示されます。
echoCharIsSet()
,
setEchoChar(char)
public void setEchoChar(char c)
エコー文字は、パスワード入力用テキストフィールドなど、ユーザ入力が画面に表示されてはならないテキストフィールドで使用されます。echoChar
= 0
に設定すると、ユーザ入力を再び画面に表示できます。
c
- このテキストフィールドのエコー文字echoCharIsSet()
,
getEchoChar()
public void setEchoCharacter(char c)
setEchoChar(char)
を使用
public void setText(String t)
TextComponent
内の setText
t
- 新しいテキストTextComponent.getText()
public boolean echoCharIsSet()
エコー文字は、パスワード入力用テキストフィールドなど、ユーザ入力が画面に表示されてはならないテキストフィールドで使用されます。
true
、そうでない場合は false
setEchoChar(char)
,
getEchoChar()
public int getColumns()
setColumns(int)
public void setColumns(int columns)
columns
- 列数
IllegalArgumentException
- columns
に指定された値が 0
より小さい場合getColumns()
public Dimension getPreferredSize(int columns)
columns
- このテキストフィールドの列数
public Dimension preferredSize(int columns)
getPreferredSize(int)
を使用
public Dimension getPreferredSize()
Component
内の getPreferredSize
Component.getMinimumSize()
,
LayoutManager
public Dimension preferredSize()
getPreferredSize()
を使用
Component
内の preferredSize
public Dimension getMinimumSize(int columns)
columns
- このテキストフィールドの列数public Dimension minimumSize(int columns)
getPreferredSize(int)
を使用
public Dimension getMinimumSize()
Component
内の getMinimumSize
Component.getPreferredSize()
,
LayoutManager
public Dimension minimumSize()
getMinimumSize()
を使用
Component
内の minimumSize
public void addActionListener(ActionListener l)
l
- アクションリスナーremoveActionListener(java.awt.event.ActionListener)
,
getActionListeners()
,
ActionListener
public void removeActionListener(ActionListener l)
l
- アクションリスナーaddActionListener(java.awt.event.ActionListener)
,
getActionListeners()
,
ActionListener
public ActionListener[] getActionListeners()
ActionListener
、または現在アクションリスナーが登録されていない場合は空の配列addActionListener(java.awt.event.ActionListener)
,
removeActionListener(java.awt.event.ActionListener)
,
java.awt.eventpublic EventListener[] getListeners(Class listenerType)
TextField
に FooListener
として、現在登録されているすべてのオブジェクトの配列を返します。FooListener
は addFooListener
メソッドを使用して登録されます。
FooListener.class
などのクラスリテラルを持つ listenerType
引数を指定できます。たとえば、次のコードを使用して、そのアクションリスナーの TextField
t
を照会できます。
ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));このようなリスナーが存在しない場合、このメソッドは空の配列を返します。
TextComponent
内の getListeners
listenerType
- 要求されたリスナーの型。このパラメータは java.util.EventListener
から派生するインタフェースを指定する
FooListener
として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが追加されなかった場合は空の配列
ClassCastException
- listenerType
が、java.util.EventListener
を実装するクラスまたはインタフェースを指定しない場合getActionListeners()
protected void processEvent(AWTEvent e)
ActionEvent
のインスタンスである場合は、processActionEvent
メソッドを呼び出します。そうでない場合はスーパークラスの processEvent
を呼び出します。
イベントパラメータが null
の場合、動作が指定されず例外が発生することに注意してください。
TextComponent
内の processEvent
e
- イベントActionEvent
,
processActionEvent(java.awt.event.ActionEvent)
protected void processActionEvent(ActionEvent e)
ActionListener
オブジェクトにディスパッチすることにより、このイベントを処理します。
このコンポーネントに対してアクションイベントが使用可能でない限り、このメソッドは呼び出されません。アクションイベントは、次のどちらかの場合に使用可能になります。
ActionListener
オブジェクトが addActionListener
によって登録されている
enableEvents
によってアクションイベントが使用可能になっている
イベントパラメータが null
の場合、動作が指定されず例外が発生することに注意してください。
e
- アクションイベントActionListener
,
addActionListener(java.awt.event.ActionListener)
,
Component.enableEvents(long)
protected String paramString()
TextField
の状態を表す文字列を返します。このメソッドは、デバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
TextComponent
内の paramString
public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
TextComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.