クラスNumberFormatter

java.lang.Object

javax.swing.JFormattedTextField.AbstractFormatter

javax.swing.text.DefaultFormatter

javax.swing.text.InternationalFormatter

javax.swing.text.NumberFormatter

すべての実装されたインタフェース:

Serializable, Cloneable

public class NumberFormatter extends InternationalFormatter

NumberFormatterは、数に関する特殊な動作を追加するInternationalFormatterをサブクラス化します。 特殊化には以下が含まれます(これらは、setAllowsInvalid(false)のように、NumberFormatterが無効な数を表示しない場合にだけ使用されます)。

• 指数フィールド以外のフィールドで+/- (「-」はDecimalFormatに関連するDecimalFormatSymbolsから判別される)を押すと、数の符号の正/負への変更が試みられる。
• 指数フィールドで+/- (「-」はDecimalFormatに関連するDecimalFormatSymbolsから判別される)を押すと、指数の符号の正/負への変更が試みられる。

科学的数値表記を使用している場合は、上書きモードsetOverwriteMode(true)をオンにします。 たとえば:

DecimalFormat decimalFormat = new DecimalFormat("0.000E0");
NumberFormatter textFormatter = new NumberFormatter(decimalFormat);
textFormatter.setOverwriteMode(true);
textFormatter.setAllowsInvalid(false);

ユーザーに10進数値の入力を許可する場合、DecimalFormatに少なくとも1つの10進数(#.0###)を持たせるか、無効なsetAllowsInvalid(true)になる値を許可する必要があります。 そうでない場合、ユーザーは10進数値を入力できません。

NumberFormatterでは、スーパー・クラスとはわずかに異なる動作をstringToValueに提供します。 値のクラスDefaultFormatter.setValueClass(Class)(Integer、Long、Float、Double、ByteまたはShortのいずれか)を指定し、フォーマットのparseObjectがNumberのインスタンスを返す場合、値クラスが表すプリミティブ型に適したコンストラクタを使用して、値クラスの対応するインスタンスが作成されます。 例えば: setValueClass(Integer.class)は結果の値をInteger.valueOf(((Number)formatter.parseObject(string)).intValue())によって作成させます。 典型的な例として、さまざまなNumberの実装が一般的に互い同士を比較できないときに、最大値や最小値を設定するのに役立ちます。 また、なんらかの理由で値に特別なNumberの実装が必要なときにも役立ちます。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.4

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
NumberFormatter()	NumberFormat.getNumberInstance()から取得されたデフォルトのNumberFormatインスタンスを使用してNumberFormatterを作成します。
NumberFormatter(NumberFormat format)	指定したFormatインスタンスを使用して、NumberFormatterを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	setFormat(Format format)	編集および表示が可能な正当な値を規定する書式を設定します。

クラスで宣言されたメソッド InternationalFormatter

clone, getActions, getFields, getFormat, getMaximum, getMinimum, install, setMaximum, setMinimum, stringToValue, valueToString

修飾子と型	メソッド	説明
Object	clone()	DefaultFormatterのコピーを作成します。
protected Action[]	getActions()	getSupportsIncrementがtrueを返す場合、値の増減に適した2つのActionを返します。
Format.Field[]	getFields(int offset)	offset位置のテキストに関連するFormat.Field定数を返します。
Format	getFormat()	編集、表示が可能な正当な値を規定する書式を返します。
Comparable<?>	getMaximum()	可能な最大値を返します。
Comparable<?>	getMinimum()	可能な最小値を返します。
void	install(JFormattedTextField ftf)	DefaultFormatterを特定のJFormattedTextFieldにインストールします。
void	setMaximum(Comparable<?> max)	可能な最大値を設定します。
void	setMinimum(Comparable<?> minimum)	可能な最小値を設定します。
Object	stringToValue(String text)	String textのObject表現を返します。
String	valueToString(Object value)	オブジェクトvalueの文字列表現を返します。

クラスで宣言されたメソッド DefaultFormatter

getAllowsInvalid, getCommitsOnValidEdit, getDocumentFilter, getNavigationFilter, getOverwriteMode, getValueClass, setAllowsInvalid, setCommitsOnValidEdit, setOverwriteMode, setValueClass

修飾子と型	メソッド	説明
boolean	getAllowsInvalid()	編集中の値を一定時間無効にできるかどうかを返します。
boolean	getCommitsOnValidEdit()	編集がいつJFormattedTextFieldに発行されるかを返します。
protected DocumentFilter	getDocumentFilter()	JFormattedTextFieldに入力可能な文字を限定するDocumentFilterを返します。
protected NavigationFilter	getNavigationFilter()	カーソルを配置できる場所を限定するNavigationFilterを返します。
boolean	getOverwriteMode()	文字の挿入時の動作を返します。
Class<?>	getValueClass()	新規Objectの作成に使用するクラスを返します。
void	setAllowsInvalid(boolean allowsInvalid)	編集中の値を一定時間無効(つまりstringToValueがParseExceptionをスローする)にできるかどうかを設定します。
void	setCommitsOnValidEdit(boolean commit)	編集がいつJFormattedTextFieldに発行されるかを設定します。
void	setOverwriteMode(boolean overwriteMode)	文字の挿入時の動作を構成します。
void	setValueClass(Class<?> valueClass)	新規Objectの作成に使用するクラスを設定します。

クラスで宣言されたメソッド JFormattedTextField.AbstractFormatter

getFormattedTextField, invalidEdit, setEditValid, uninstall

修飾子と型	メソッド	説明
protected JFormattedTextField	getFormattedTextField()	AbstractFormatterがインストールされている現在のJFormattedTextFieldを返します。
protected void	invalidEdit()	これはユーザーが不正な文字を入力したときに呼び出されます。
protected void	setEditValid(boolean valid)	JFormattedTextFieldのeditValidプロパティを更新するために呼び出します。
void	uninstall()	JFormattedTextFieldにインストールされた、任意の状態のAbstractFormatterをアンインストールします。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

NumberFormatter

public NumberFormatter()

NumberFormat.getNumberInstance()から取得されたデフォルトのNumberFormatインスタンスを使用してNumberFormatterを作成します。

NumberFormatter

public NumberFormatter(NumberFormat format)

指定したFormatインスタンスを使用して、NumberFormatterを作成します。

パラメータ:

format - 正当な値の規定に使用する書式

メソッドの詳細

setFormat

public void setFormat(Format format)

編集および表示が可能な正当な値を規定する書式を設定します。

nullのコンストラクタを使用した場合、このプロパティの値は、NumberFormat.getNumberInstance()メソッドによって現在のロケールに決定されます。

オーバーライド:

setFormat、クラスInternationalFormatter

パラメータ:

format - 適正な値の規定に使用するNumberFormatインスタンス