com.docomostar.ui.Component
com.docomostar.ui.TextBox
|
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||
Object
public final class TextBox
テキスト入力コンポーネントを定義します。 テキストボックスクラスは、 高レベル API で使用するUI部品の一つで、 テキスト入力のためのコンポーネントです。
テキスト入力コンポーネントでは、 表示行数が1行の場合と2行以上の場合で動作が異なります。
テキスト文字列には通常の文字列またはXStringの文字列が指定できます。 これらは排他的に動作します。 通常の文字列が設定されている場合にXStringの文字列を設定すると、 表示される文字列はXStringの内容に置き換わります。 このとき、getTextメソッドを呼び出すと、nullが返ります。 逆に、XStringの文字列が設定されている場合に通常の文字列を設定すると、 表示される文字列は通常の文字列の内容に置き換わります。 このとき、getXTextメソッドを呼び出すと、nullが返ります。 XStringの文字列が設定されている場合、編集することはできません。
テキスト文字列に入力可能な文字数を制限することができます。 文字数を制限した場合、その後のユーザ入力、及び、メソッド呼び出し (setText(String)、setText(XString))
によるテキスト文字列の設定では、
制限数を超える文字列を設定することはできません。
| フィールドの概要 | |
|---|---|
static int |
ALPHA
初期入力モードを半角アルファベット入力モードにすることを表します (=1)。 |
static int |
DISPLAY_ANY
表示文字列をそのまま表示するモードにすることを表します (=0)。 |
static int |
DISPLAY_PASSWORD
文字列を隠蔽して表示するモード (パスワード入力用の表示モード) にすることを表します (=1)。 |
static int |
HANGUL [iアプリオプションAPI]
初期入力モードを韓国語(ハングル文字)入力モードにすることを表します (=6)。 |
static int |
INPUTSIZE_UNLIMITED [iアプリオプションAPI]
入力文字数の制限値を無制限にすることを表します (=0)。 |
static int |
KANA
初期入力モードをかな漢字入力モードにすることを表します (=2)。 |
static int |
NUMBER
初期入力モードを半角数字入力モードにすることを表します (=0)。 |
static int |
PORTUGUESE [iアプリオプションAPI]
初期入力モードをポルトガル語入力モードにすることを表します (=7)。 |
static int |
SIMPLIFIED_HANZI [iアプリオプションAPI]
初期入力モードを中国語(簡体字)入力モードにすることを表します (=4)。 |
static int |
TRADITIONAL_HANZI [iアプリオプションAPI]
初期入力モードを中国語(繁体字)入力モードにすることを表します (=3)。 |
| コンストラクタの概要 | |
|---|---|
TextBox(String text,
int columns,
int rows,
int mode)
初期文字列と桁数、行数、 表示モードを指定してテキストボックスを生成します。 |
|
TextBox(XString xText,
int columns,
int rows,
int mode)
初期文字列(XString)と桁数、 行数、表示モードを指定してテキストボックスを生成します。 |
|
| メソッドの概要 | |
|---|---|
String |
getText()
テキスト文字列を取得します。 |
XString |
getXText()
テキスト文字列(XString)を取得します。 |
void |
requestFocus()
コンポーネントにフォーカスをセットするよう要求します。 |
void |
setEditable(boolean b)
テキスト文字列を編集可能にするかどうかを設定します。 |
void |
setEnabled(boolean b)
コンポーネントを有効状態(ユーザ操作可能な状態)にしたり 無効状態(ユーザ操作不能な状態)にしたりします。 |
void |
setInputMode(int mode)
テキスト文字列の初期入力モードを設定します。 |
void |
setInputSize(int inputSize) [iアプリオプションAPI]
テキスト文字列に入力可能な文字数を制限します。 |
void |
setText(String text)
テキスト文字列を設定します。 |
void |
setText(XString xText)
テキスト文字列を XString の文字列で設定します。 |
| クラス com.docomostar.ui.Component から継承されたメソッド |
|---|
getHeight, getWidth, getX, getY, setBackground, setFont, setForeground, setLocation, setSize, setVisible |
| クラス Object から継承されたメソッド |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| フィールドの詳細 |
|---|
public static final int NUMBER
public static final int ALPHA
public static final int KANA
public static final int TRADITIONAL_HANZI [iアプリオプションAPI]
public static final int SIMPLIFIED_HANZI [iアプリオプションAPI]
public static final int HANGUL [iアプリオプションAPI]
public static final int PORTUGUESE [iアプリオプションAPI]
public static final int DISPLAY_ANY
この表示モードに設定したテキストボックスのデフォルトの初期入力モードは、
かな漢字入力モード です。
public static final int DISPLAY_PASSWORD
文字列を隠蔽して表示するモード (パスワード入力用の表示モード) にすることを表します (=1)。
この表示モードに設定したテキストボックスのデフォルトの初期入力モードは、
数字入力モードです。
また、その時に入力可能な文字種は、
ブラウザにおけるパスワード入力用テキストボックスと同様です。
public static final int INPUTSIZE_UNLIMITED [iアプリオプションAPI]
| コンストラクタの詳細 |
|---|
public TextBox(String text,
int columns,
int rows,
int mode)
初期文字列と桁数、行数、 表示モードを指定してテキストボックスを生成します。
生成時には、表示可能で、ユーザ操作可能になっています。
また、生成時の初期入力モードは、
引数に指定する表示モードにより異なります。
詳細は、各表示モード
(DISPLAY_ANY、DISPLAY_PASSWORD)
の説明を参照して下さい。
表示可能、表示不能を設定するには、Component.setVisible(boolean)
メソッドを使用します。
ユーザ操作可能、ユーザ操作不能を設定するには、
setEnabled(boolean) メソッドを使用します。
初期入力モードを切り替えるには、
setInputMode(int) メソッドを使用します。
text - 初期文字列を指定します。null が指定された場合、
空文字列("")が設定されます。columns - 桁数を指定します。桁数は、半角文字数で数えます。rows - 行数を指定します。mode - 文字列の表示モードを指定します。
DISPLAY_ANY または、DISPLAY_PASSWORD を指定します。
IllegalArgumentException -
IllegalArgumentException -
public TextBox(XString xText,
int columns,
int rows,
int mode)
Component.setVisible(boolean)
メソッドを使用します。
XString の文字列が設定されている限り、編集可能にはできません。
xText - 初期文字列をXStringで指定します。
null が指定された場合、
表示文字列には空文字("")が設定されます。columns - 桁数を指定します。桁数は、半角文字数で数えます。rows - 行数を指定します。mode - 文字列の表示モードを指定します。
DISPLAY_ANY または、DISPLAY_PASSWORD
を指定します。
IllegalArgumentException -
IllegalArgumentException -
| メソッドの詳細 |
|---|
public void setText(String text)
ComponentListener.TEXT_CHANGED)
が発生します。
不可視、可視に関わらず、このメソッドの呼び出しにより、 テキスト文字列が設定されます。 ただし、イベントは可視の場合だけ発生します。 また、ユーザ操作可能/不能に関わらず、このメソッドは機能します。
テキスト文字列に入力可能な文字数が制限されている場合、 引数 text に指定する文字列の文字数は制限値以内でなければなりません。 入力可能な文字数の制限値を超える文字列を指定した場合は、 例外 UIException(ILLEGAL_STATE) が発生します。
text - テキスト文字列を指定します。
null が指定された場合は空文字列("")が設定されます。