|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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 から継承した内部クラス |
TextComponent.AccessibleAWTTextComponent |
クラス java.awt.Component から継承した内部クラス |
Component.AccessibleAWTComponent |
クラス 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 を返します。 |
int |
getColumns()
このテキストフィールドの列数を返します。 |
char |
getEchoChar()
エコー用に使用される文字を返します。 |
EventListener[] |
getListeners(Class listenerType)
addXXXListener() によって TextField に追加された全リスナーの配列を返します。 |
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 以降は、 getMinimumSize(int) に置き換えられました。 |
protected String |
paramString()
このテキストフィールドの状態を表すパラメータの文字列を返します。 |
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()
public TextField(String text)
text
- 表示するテキスト。text
が null
の場合は、空の文字列 ""
が表示されるpublic TextField(int columns)
columns
- 列数。columns
が 0
より小さい場合、columns
は 0
に設定されるpublic TextField(String text, int columns)
text
- 表示するテキスト。text
が null
の場合は、空の文字列 ""
が表示されるcolumns
- 列数。columns
が 0
より小さい場合、columns
は 0
に設定されるメソッドの詳細 |
public void addNotify()
Component
内の addNotify
java.awt.Component
からコピーされたタグ:Component.isDisplayable()
,
Component.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
public Dimension preferredSize()
getPreferredSize()
に置き換えられました。
Component
内の preferredSize
public Dimension getMinimumSize(int columns)
columns
- このテキストフィールドの列数public Dimension minimumSize(int columns)
getMinimumSize(int)
に置き換えられました。
public Dimension getMinimumSize()
Component
内の getMinimumSize
public Dimension minimumSize()
getMinimumSize()
に置き換えられました。
Component
内の minimumSize
public void addActionListener(ActionListener l)
l
- アクションリスナーremoveActionListener(java.awt.event.ActionListener)
public void removeActionListener(ActionListener l)
l
- アクションリスナーaddActionListener(java.awt.event.ActionListener)
public EventListener[] getListeners(Class listenerType)
listenerType
の引数の名前です。たとえば、指定された TextField t
の ActionListener(s) をすべて取得するには、次のように記述します。
ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class))該当するリスナーリストが存在しない場合は、空の配列が返されます。
TextComponent
内の getListeners
listenerType
- 要求されたリスナーのタイプprotected void processEvent(AWTEvent e)
ActionEvent
のインスタンスである場合は、processActionEvent
メソッドを呼び出します。そうでない場合はスーパークラスの processEvent
を呼び出します。TextComponent
内の processEvent
e
- イベントActionEvent
,
processActionEvent(java.awt.event.ActionEvent)
protected void processActionEvent(ActionEvent e)
ActionListener
オブジェクトにディスパッチすることにより、このイベントを処理します。
このコンポーネントに対してアクションイベントが使用可能でない限り、このメソッドは呼び出されません。アクションイベントは、次のどちらかの場合に使用可能になります。
ActionListener
オブジェクトが addActionListener
によって登録されている
enableEvents
によってアクションイベントが使用可能になっている
e
- アクションイベントActionListener
,
addActionListener(java.awt.event.ActionListener)
,
Component.enableEvents(long)
protected String paramString()
TextComponent
内の paramString
public AccessibleContext getAccessibleContext()
TextComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.