appendix> Component> JTextField TOPUPPREVNEXT

javax.swing.JTextField

【主な機能】

1行のテキストの入力欄です。 ActionListener を登録すると、Enter キー が押されたときに発生する ActionEvent を受け取ることができます。 編集を不可にして、表示専用にすることも可能です。

【継承関係】


   java.lang.Object
      └ java.awt.Component
            └ java.awt.Container
                  └ javax.swing.JComponent
                        └ javax.swing.text.JTextComponent
                              └ javax.swing.JTextField
  

【主なコンストラクタ】

コンストラクタ機能
JTextField ( )  
JTextField ( int cols )  
JTextField ( String text )  
JTextField ( String text, int cols ) 長さ cols 桁で、文字列 text があらかじめ 設定されているテキスト・フィールドを生成します。

【よく使われるメソッド】

メソッド機能
void addActionListener ( ActionListener l ) アクションリスナを登録します。
void setColumns ( int cols ) このテキストフィールドの桁数を設定し、配置を無効にします。
void setFont ( Font f ) フォントを設定します。
void setHorizontalAlignment ( int align ) テキストの横方向の配置を指定します。 align
  • SwingConstants.LEFT      ... 左詰め
  • SwingConstants.CENTER    ... 中央揃え
  • SwingConstants.RIGHT     ... 右詰め
  • SwingConstants.LEADING   ... (注1)
  • SwingConstants.TRAILING  ... (注2)
デフォルトは、LEADING 。

(注1)左から右に書く言語では左詰め、右から左へ書く言語では右詰め。
(注2)左から右に書く言語では右詰め、右から左へ書く言語では左詰め。

【JTextComponentから継承した主なメソッド】

メソッド機能
String getText ( ) テキスト・フィールドにある文字列を返します。
String getText ( int offs, int len ) テキスト・フィールドにある文字列の、offs 文字目から len 文字を返します。
void setEditable ( boolean b ) このテキスト・フィールドを編集できないようにするには、 bfalse を指定します。
void setText ( String s ) テキスト・フィールドに、文字列 s を設定します。

【JComponentから継承した主なメソッド】

メソッド機能
void requestFocus ( ) フォーカスを設定します。今後のキーボード入力は、このフィールドに入力されます。

【キー割り当て】

テキスト・フィールド内のテキストの編集に使うキーは、Look&Feel ごとに決められていますが、 よく使うキーは、Java、Motif、Windows ともに共通で以下のようになっています。

動作キー
→ ← 右に1文字、左に1文字 移動
Home End フィールドの先頭、最後に 移動
Ctrl+A 全選択
Shift+→ Shift+← 選択範囲を右に、左に拡張
Ctrl+Home Ctrl+End 選択範囲を先頭、最後まで拡張
Ctrl+C 選択範囲のコピー
Ctrl+X 選択範囲の切り取り
Ctrl+V クリップボードからの貼り付け
Delete 次の文字の削除
BackSpace 前の文字の削除

タブ文字は、コンポーネント間のフォーカスの移動に消費されますので、 テキスト・フィールドには入力されません。

【使用例】

getText の使用例

テキストを入力し、Enter キーを押した時数値を取り出し、上のラベルの数値に加算します。

 プログラム JTextFieldDemo5.java

実行直後    JTextFieldDemo5-1.gif

12 を入力   JTextFieldDemo5-2.gif

34 を入力   JTextFieldDemo5-3.gif

加算後、入力された文字列を退避し、JTextField をクリアします。

 プログラム JTextFieldDemo5c.java    実行例  JTextFieldDemo5c-1.jpg

フォントを指定します。フォントについては Font

 プログラム JTextFieldDemo5f.java    実行例  JTextFieldDemo5f-1.jpg

getText と setText の使用例

テキストを入力し、Enter キーを押した時、文字列を逆順に表示します。

プログラム JTextFieldDemo1.java

実行直後    JTextFieldDemo1-1.gif

文字編集    JTextFieldDemo1-2.gif    JTextFieldDemo1-3.gif

Enter入力後  JTextFieldDemo1-4.gif

setHorizontalAlignment の使用例

右詰で数字を入力し、Enter キーを押した時、符号を反転して表示します。

プログラム JTextFieldDemo2.java

入力文字    JTextFieldDemo2-1.gif

Enter入力後  JTextFieldDemo2-2.gif


更新日:2008-06-14