Java プラットフォーム 1.2 API 仕様: クラス TextField

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.awt
クラス TextField

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.TextComponent
              |
              +--java.awt.TextField

public class TextField
extends TextComponent

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);

ユーザがテキストフィールドでキーを入力するたびに、AWT は 2 つのアクションイベントをテキストフィールドに送信します。1 番目のアクションイベントはキーが押されたことを表し、2 番目のアクションイベントはキーが離されたことを表します。各アクションイベントはアクションが発生した時点でのシステムの状態を具現化します。アクションイベントのプロパティは、押されたキー、キーと一緒に押された修飾キー、およびイベントが発生した時点を示します。

このイベントは ActionEvent のインスタンスなので、TextField クラスの processEvent メソッドがイベントを調べて processActionEvent メソッドに渡します。後者のメソッドは、このテキストフィールドによって生成されるアクションイベントの通知を登録しているすべての ActionListener オブジェクトにイベントを転送します。

導入されたバージョン:: JDK1.0
関連項目:: ActionEvent, processEvent(java.awt.AWTEvent), processActionEvent(java.awt.event.ActionEvent), 直列化された形式

クラス java.awt.TextComponent から継承したフィールド

textListener

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT,  
CENTER_ALIGNMENT,  
LEFT_ALIGNMENT,  
RIGHT_ALIGNMENT,  
TOP_ALIGNMENT

コンストラクタの概要
`TextField()` 新しいテキストフィールドを構築します。
`TextField(int columns)` 指定された列数で初期化された新しい空の TextField を構築します。
`TextField(String text)` 指定されたテキストで初期化された新しいテキストフィールドを構築します。
`TextField(String text, int columns)` 指定されたテキストが表示されるように初期化され、指定された列数を表示できる幅の新しいテキストフィールドを構築します。

メソッドの概要
`void`	`addActionListener(ActionListener l)` このテキストフィールドのアクションイベントを受け取るために、指定されたアクションリスナーを追加します。
`void`	`addNotify()` TextField のピアを作成します。
`boolean`	`echoCharIsSet()` このテキストフィールドでエコー用の文字が設定されているかどうかを示します。
`int`	`getColumns()` このテキストフィールドの列数を取得します。
`char`	`getEchoChar()` エコー用に使用される文字を取得します。
`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.awt.TextComponent から継承したメソッド

addTextListener, 
getCaretPosition, 
getSelectedText, 
getSelectionEnd, 
getSelectionStart, 
getText, 
isEditable, 
processTextEvent, 
removeNotify, 
removeTextListener, 
select, 
selectAll, 
setCaretPosition, 
setEditable, 
setSelectionEnd, 
setSelectionStart

クラス java.awt.Component から継承したメソッド

action, 
add, 
addComponentListener, 
addFocusListener, 
addInputMethodListener, 
addKeyListener, 
addMouseListener, 
addMouseMotionListener, 
addPropertyChangeListener, 
addPropertyChangeListener, 
bounds, 
checkImage, 
checkImage, 
coalesceEvents, 
contains, 
contains, 
createImage, 
createImage, 
deliverEvent, 
disable, 
disableEvents, 
dispatchEvent, 
doLayout, 
enable, 
enable, 
enableEvents, 
enableInputMethods, 
firePropertyChange, 
getAlignmentX, 
getAlignmentY, 
getBackground, 
getBounds, 
getBounds, 
getColorModel, 
getComponentAt, 
getComponentAt, 
getComponentOrientation, 
getCursor, 
getDropTarget, 
getFont, 
getFontMetrics, 
getForeground, 
getGraphics, 
getHeight, 
getInputContext, 
getInputMethodRequests, 
getLocale, 
getLocation, 
getLocation, 
getLocationOnScreen, 
getMaximumSize, 
getName, 
getParent, 
getPeer, 
getSize, 
getSize, 
getToolkit, 
getTreeLock, 
getWidth, 
getX, 
getY, 
gotFocus, 
handleEvent, 
hasFocus, 
hide, 
imageUpdate, 
inside, 
invalidate, 
isDisplayable, 
isDoubleBuffered, 
isEnabled, 
isFocusTraversable, 
isLightweight, 
isOpaque, 
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, 
processInputMethodEvent, 
processKeyEvent, 
processMouseEvent, 
processMouseMotionEvent, 
remove, 
removeComponentListener, 
removeFocusListener, 
removeInputMethodListener, 
removeKeyListener, 
removeMouseListener, 
removeMouseMotionListener, 
removePropertyChangeListener, 
removePropertyChangeListener, 
repaint, 
repaint, 
repaint, 
repaint, 
requestFocus, 
reshape, 
resize, 
resize, 
setBackground, 
setBounds, 
setBounds, 
setComponentOrientation, 
setCursor, 
setDropTarget, 
setEnabled, 
setFont, 
setForeground, 
setLocale, 
setLocation, 
setLocation, 
setName, 
setSize, 
setSize, 
setVisible, 
show, 
show, 
size, 
toString, 
transferFocus, 
update, 
validate

クラス java.lang.Object から継承したメソッド

clone, 
equals, 
finalize, 
getClass, 
hashCode, 
notify, 
notifyAll, 
wait, 
wait, 
wait

コンストラクタの詳細

TextField

public TextField()

新しいテキストフィールドを構築します。

TextField

public TextField(String text)

指定されたテキストで初期化された新しいテキストフィールドを構築します。

パラメータ:: text - 表示されるテキスト。text が null の場合は、空の文字列 "" が表示される

TextField

public TextField(int columns)

指定された列数で初期化された新しい空の TextField を構築します。列幅は、プラットフォームに依存するおよその平均文字幅になります。

パラメータ:: columns - 列数

TextField

public TextField(String text,
                 int columns)

指定されたテキストが表示されるように初期化され、指定された列数を表示できる幅の新しいテキストフィールドを構築します。列幅は、プラットフォームに依存するおよその平均文字幅になります。

パラメータ:: text - 表示するテキスト。text が null の場合は、空の文字列 "" が表示される; columns - 列数

メソッドの詳細

addNotify

public void addNotify()

TextField のピアを作成します。ピアは、機能を変更せずに TextField の外見を変更することを可能にします。

オーバーライド:: クラス Component 内の addNotify

getEchoChar

public char getEchoChar()

エコー用に使用される文字を取得します。

エコー文字は、パスワード入力用テキストフィールドなど、ユーザ入力が画面に表示されてはならないテキストフィールドで使用されます。

戻り値:: このテキストフィールドのエコー文字
関連項目:: echoCharIsSet(), setEchoChar(char)

setEchoChar

public void setEchoChar(char c)

このテキストフィールドのエコー文字を設定します。

エコー文字は、パスワード入力用テキストフィールドなど、ユーザ入力が画面に表示されてはならないテキストフィールドで使用されます。

パラメータ:: c - このテキストフィールドのエコー文字
導入されたバージョン:: JDK1.1
関連項目:: echoCharIsSet(), getEchoChar()

setEchoCharacter

public void setEchoCharacter(char c)

推奨されません。 JDK バージョン 1.1 以降は、setEchoChar(char) に置き換えられました。

setText

public void setText(String t)

このテキストコンポーネントで表示されるテキストを、指定されたテキストに設定します。

パラメータ:: t - 新しいテキスト
オーバーライド:: クラス TextComponent 内の setText
関連項目:: TextComponent.getText()

echoCharIsSet

public boolean echoCharIsSet()

このテキストフィールドでエコー用の文字が設定されているかどうかを示します。

エコー文字は、パスワード入力用テキストフィールドなど、ユーザ入力が画面に表示されてはならないテキストフィールドで使用されます。

戻り値:: このテキストフィールドでエコー用の文字が設定されている場合は true、そうでない場合は false
関連項目:: setEchoChar(char), getEchoChar()

getColumns

public int getColumns()

このテキストフィールドの列数を取得します。

戻り値:: 列数
導入されたバージョン:: JDK1.1ld.
関連項目:: setColumns(int)

setColumns

public void setColumns(int columns)

このテキストフィールドの列数を設定します。列幅は、プラットフォーム依存のおよその平均文字幅になります。

パラメータ:: columns - 列数
例外:: IllegalArgumentException - columns に指定された値が 0 未満の場合
導入されたバージョン:: JDK1.1
関連項目:: getColumns()

getPreferredSize

public Dimension getPreferredSize(int columns)

指定された列数での、このテキストフィールドの推奨サイズを取得します。

パラメータ:: columns - このテキストフィールドの列数
戻り値:: このテキストフィールドを表示するための推奨サイズ
導入されたバージョン:: JDK1.1

preferredSize

public Dimension preferredSize(int columns)

推奨されません。 JDK バージョン 1.1 以降は、getPreferredSize(int) に置き換えられました。

getPreferredSize

public Dimension getPreferredSize()

このテキストフィールドの推奨サイズを取得します。

戻り値:: このテキストフィールドを表示するための推奨サイズ
オーバーライド:: クラス Component 内の getPreferredSize
導入されたバージョン:: JDK1.1

preferredSize

public Dimension preferredSize()

推奨されません。 JDK バージョン 1.1 以降は、getPreferredSize() に置き換えられました。

オーバーライド:: クラス Component 内の preferredSize

getMinimumSize

public Dimension getMinimumSize(int columns)

指定された列数での、このテキストフィールドの最小サイズを取得します。

パラメータ:: columns - このテキストフィールドの列数
導入されたバージョン:: JDK1.1

minimumSize

public Dimension minimumSize(int columns)

推奨されません。 JDK バージョン 1.1 以降は、getMinimumSize(int) に置き換えられました。

getMinimumSize

public Dimension getMinimumSize()

このテキストフィールドの最小サイズを取得します。

戻り値:: このテキストフィールドを表示するための最小サイズ
オーバーライド:: クラス Component 内の getMinimumSize
導入されたバージョン:: JDK1.1

minimumSize

public Dimension minimumSize()

推奨されません。 JDK バージョン 1.1 以降は、getMinimumSize() に置き換えられました。

オーバーライド:: クラス Component 内の minimumSize

addActionListener

public void addActionListener(ActionListener l)

このテキストフィールドのアクションイベントを受け取るために、指定されたアクションリスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: l - アクションリスナー
導入されたバージョン:: JDK1.1
関連項目:: java.awt.event, removeActionListener(java.awt.event.ActionListener)

removeActionListener

public void removeActionListener(ActionListener l)

以降このテキストフィールドからアクションイベントを受け取らないように、指定されたアクションリスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。

パラメータ:: l - アクションリスナー
導入されたバージョン:: JDK1.1
関連項目:: java.awt.event, addActionListener(java.awt.event.ActionListener)

processEvent

protected void processEvent(AWTEvent e)

このテキストフィールドのイベントを処理します。イベントが ActionEvent のインスタンスである場合は、processActionEvent メソッドを呼び出します。そうでない場合はスーパークラスの processEvent を呼び出します。

パラメータ:: e - イベント
オーバーライド:: クラス TextComponent 内の processEvent
導入されたバージョン:: JDK1.1
関連項目:: ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

このテキストフィールドで発生するアクションイベントを、登録された ActionListener オブジェクトにディスパッチすることにより、アクションイベントを処理します。

このコンポーネントに対してアクションイベントが使用可能でない限り、このメソッドは呼び出されません。アクションイベントは、次のどちらかの場合に使用可能になります。

ActionListener オブジェクトが addActionListener によって登録されている
enableEvents によってアクションイベントが使用可能になっている

パラメータ:: e - アクションイベント
導入されたバージョン:: JDK1.1
関連項目:: ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

このテキストフィールドの状態を表すパラメータの文字列を返します。この文字列はデバッグに使用します。

戻り値:: このテキストフィールドのパラメータの文字列
オーバーライド:: クラス TextComponent 内の paramString

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.

java.awt クラス TextField

TextField

TextField

TextField

TextField

addNotify

getEchoChar

setEchoChar

setEchoCharacter

setText

echoCharIsSet

getColumns

setColumns

getPreferredSize

preferredSize

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMinimumSize

minimumSize

addActionListener

removeActionListener

processEvent

processActionEvent

paramString

java.awt
クラス TextField