javax.swing.text

クラス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に提供します。値のClassとして、Integer、Long、Float、Double、Byte、Shortのいずれかを指定(DefaultFormatter.setValueClass(java.lang.Class<?>))していて、FormatのparseObjectがNumberのインスタンスを返す場合、値クラスの対応するインスタンスは、値クラスが表すプリミティブ型に適したコンストラクタを使用して作成されます。たとえば、setValueClass(Integer.class)は、結果としてnew Integer(((Number)formatter.parseObject(string)).intValue())で作成される値となります。典型的な例として、さまざまなNumberの実装が一般的に互い同士を比較できないときに、最大値や最小値を設定するのに役立ちます。また、なんらかの理由で値に特別なNumberの実装が必要なときにも役立ちます。

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

導入されたバージョン:

1.4

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

コンストラクタ

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

メソッドのサマリー

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

クラス javax.swing.text.InternationalFormatterから継承されたメソッド

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

クラス javax.swing.text.DefaultFormatterから継承されたメソッド

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

クラス javax.swing.JFormattedTextField.AbstractFormatterから継承されたメソッド

getFormattedTextField, invalidEdit, setEditValid, uninstall

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

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

コンストラクタの詳細

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インスタンス