JavaTM Platform
Standard Ed. 6

javax.swing.text
クラス InternationalFormatter

java.lang.Object
  上位を拡張 javax.swing.JFormattedTextField.AbstractFormatter
      上位を拡張 javax.swing.text.DefaultFormatter
          上位を拡張 javax.swing.text.InternationalFormatter
すべての実装されたインタフェース:
Serializable, Cloneable
直系の既知のサブクラス:
DateFormatter, NumberFormatter

public class InternationalFormatter
extends DefaultFormatter

InternationalFormatter は、String への変換と String からの変換を処理する java.text.Format のインスタンスを使用して、DefaultFormatter を拡張します。

getAllowsInvalid() が false の場合、各編集の現行テキストに書式を付けるよう Format に求めます。

setMinimum メソッドと setMaximum メソッドで最小値と最大値を指定できます。これを有効にするには、stringToValue から返された値が、Comparable インタフェースを介して最大値/最小値と比較可能でなければなりません。

特定の値が入力不可になるといった状況を作り出すことがあるため、FormatInternationalFormatter の構成方法には注意が必要です。常に有効な InternationalFormatter (setAllowsInvalid(false)) である日付書式「M/d/yy」が上書きモード (setOverwriteMode(true)) であり、日付は 7/1/99 であるとします。 この場合、ユーザーは 2 桁の月および日付を入力できません。これを回避するには、書式を 「MM/dd/yy」にする必要があります。

InternationalFormatter が、有効な値 (setAllowsInvalid(false)) だけを許可するように構成されている場合、有効な各編集は、Format から完全にリセットされた JFormattedTextField のテキストになります。またカーソル位置は、リテラル文字が結果として得られる String に対して追加または削除されるように調整されます。

stringToValueInternationalFormatter の動作は、DefaultTextFormatter の動作とはわずかに違います。この場合は以下を実行します。

  1. parseObject は、setFormat で指定された Format 上で呼び出される
  2. Class がその値に設定されると (setValueClass)、スーパークラスの実装が呼び出され、parseObject から返された値を適切なクラスに変換する
  3. ParseException がスローされておらず、またその値が最大値、最小値の範囲外である場合、ParseException がスローされる
  4. 値が返される
Format が返す代替 Class を指定するには、InternationalFormatter がこの方法で stringToValue を実装します。

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

導入されたバージョン:
1.4
関連項目:
Format, Comparable

コンストラクタの概要
InternationalFormatter()
          Format を指定せずに、InternationalFormatter を作成します。
InternationalFormatter(Format format)
          Format のインスタンスを指定して、InternationalFormatter を作成します。
 
メソッドの概要
 Object clone()
          DefaultFormatter のコピーを作成します。
protected  Action[] getActions()
          getSupportsIncrement が true を返す場合、値の増減に適した二つの Action を返します。
 Format.Field[] getFields(int offset)
          offset 位置のテキストに関連する Format.Field 定数を返します。
 Format getFormat()
          編集、表示が可能な正当な値を規定する書式を返します。
 Comparable getMaximum()
          可能な最大値を返します。
 Comparable getMinimum()
          可能な最小値を返します。
 void install(JFormattedTextField ftf)
          DefaultFormatter を特定の JFormattedTextField にインストールします。
 void setFormat(Format format)
          編集および表示が可能な正当な値を規定する書式を設定します。
 void setMaximum(Comparable max)
          可能な最大値を設定します。
 void setMinimum(Comparable minimum)
          可能な最小値を設定します。
 Object stringToValue(String text)
          String textObject 表現を返します。
 String valueToString(Object value)
          Object の value の文字列表現を返します。
 
クラス 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
 

コンストラクタの詳細

InternationalFormatter

public InternationalFormatter()
Format を指定せずに、InternationalFormatter を作成します。


InternationalFormatter

public InternationalFormatter(Format format)
Format のインスタンスを指定して、InternationalFormatter を作成します。

パラメータ:
format - String との相互変換に使用される Format インスタンス
メソッドの詳細

setFormat

public void setFormat(Format format)
編集および表示が可能な正当な値を規定する書式を設定します。

パラメータ:
format - String との相互変換に使用される Format のインスタンス

getFormat

public Format getFormat()
編集、表示が可能な正当な値を規定する書式を返します。

戻り値:
String との相互変換に使用される Format インスタンス

setMinimum

public void setMinimum(Comparable minimum)
可能な最小値を設定します。valueClass が未指定で minimum が null 以外の場合、valueClassminimum クラスの valueClass に設定されます。

パラメータ:
minimum - 入力可能な最小適正値
関連項目:
DefaultFormatter.setValueClass(java.lang.Class)

getMinimum

public Comparable getMinimum()
可能な最小値を返します。

戻り値:
入力可能な最小適正値

setMaximum

public void setMaximum(Comparable max)
可能な最大値を設定します。valueClass が未指定で、max が null 以外の場合、valueClassmax クラスの valueClass に設定されます。

パラメータ:
max - 入力可能な最大適正値
関連項目:
DefaultFormatter.setValueClass(java.lang.Class)

getMaximum

public Comparable getMaximum()
可能な最大値を返します。

戻り値:
入力可能な最大適正値

install

public void install(JFormattedTextField ftf)
DefaultFormatter を特定の JFormattedTextField にインストールします。これにより valueToString が呼び出されて、現在の値が JFormattedTextField から String へ変換されます。次に getActions からの ActiongetDocumentFilter から返された DocumentFiltergetNavigationFilter から返された NavigationFilter が、JFormattedTextField にインストールされます。

通常、サブクラスでのオーバーライドが必要になるのは、JFormattedTextField に追加リスナーをインストールする場合だけです。

現在の値を文字列に変換するときに ParseException が発生した場合は、テキストとして空の文字列が設定され、JFormattedTextField に不正な状態を示す値が設定されます。

これは public メソッドですが、通常は JFormattedTextField のサブクラスに対してだけ有効です。値が変更されるか、内部状態が変更される場合、JFormattedTextField によりこのメソッドが呼び出されます。

オーバーライド:
クラス DefaultFormatter 内の install
パラメータ:
ftf - フォーマット対象の JformattedTextField。 null の場合は、現在の JFormattedTextField からのアンインストールを示す

valueToString

public String valueToString(Object value)
                     throws ParseException
Object の value の文字列表現を返します。これにより、現在の Format 上で format が呼び出されます。

オーバーライド:
クラス DefaultFormatter 内の valueToString
パラメータ:
value - 変換対象の値
戻り値:
値の文字列表現
例外:
ParseException - 変換でエラーが発生した場合

stringToValue

public Object stringToValue(String text)
                     throws ParseException
String textObject 表現を返します。

オーバーライド:
クラス DefaultFormatter 内の stringToValue
パラメータ:
text - 変換する String
戻り値:
テキストの Object 表現
例外:
ParseException - 変換でエラーが発生した場合

getFields

public Format.Field[] getFields(int offset)
offset 位置のテキストに関連する Format.Field 定数を返します。offset の位置が現在のテキスト内で不正である場合は、空の配列が返されます。

パラメータ:
offset - 検査するテキストへのオフセット
戻り値:
指定された位置のテキストに関連した Format.Field 定数

clone

public Object clone()
             throws CloneNotSupportedException
DefaultFormatter のコピーを作成します。

オーバーライド:
クラス DefaultFormatter 内の clone
戻り値:
DefaultFormatter のコピー
例外:
CloneNotSupportedException - オブジェクトのクラスが Cloneable インタフェースをサポートしていない場合。clone メソッドをオーバーライドしたサブクラスも、インスタンスを複製できないことを示すためにこの例外をスローすることがある
関連項目:
Cloneable

getActions

protected Action[] getActions()
getSupportsIncrement が true を返す場合、値の増減に適した二つの Action を返します。

オーバーライド:
クラス JFormattedTextField.AbstractFormatter 内の getActions
戻り値:
JformattedTextField にインストールするアクションの配列

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。