JavaTM Platform
Standard Ed. 6

javax.swing
クラス JFormattedTextField.AbstractFormatter

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

public abstract static class JFormattedTextField.AbstractFormatter
extends Object
implements Serializable

AbstractFormatter のインスタンスは、Object から String および String から Object への変換を処理するために JFormattedTextField で使用されます。AbstractFormatter は、編集ポリシ−またはナビゲーションポリシーを強化したり、JFormattedTextField の表示方法を操作して必要なポリシーを強化することができます。

AbstractFormatter は一度に 1 つの JFormattedTextField だけで有効です。JFormattedTextField は使用準備ができたときに install を呼び出し、使用を終了すると uninstall を呼び出します。追加の状態をインストールするサブクラスは必要に応じて install をオーバーライドし、上位クラスに通知を行います。

サブクラスは変換メソッドの stringToValuevalueToString をオーバーライドする必要があります。特定の方法で getActionsgetNavigationFilter、および getDocumentFilter をオーバーライドし、JFormattedTextField を制限することもできます。

JFormattedTextField を一時的に無効な状態にすることを許可するサブクラスでは、適切なタイミングで setEditValid を呼び出す必要があります。

導入されたバージョン:
1.4

コンストラクタの概要
JFormattedTextField.AbstractFormatter()
           
 
メソッドの概要
protected  Object clone()
          AbstractFormatter を複製します。
protected  Action[] getActions()
          Action のカスタムセットを提供する場合は、サブクラス化してオーバーライドします。
protected  DocumentFilter getDocumentFilter()
          入力を制限する DocumentFilter を提供する場合は、サブクラス化し、オーバーライドします。
protected  JFormattedTextField getFormattedTextField()
          AbstractFormatter がインストールされている現在の JFormattedTextField を返します。
protected  NavigationFilter getNavigationFilter()
          ユーザーのナビゲート先を制限するフィルタを提供する場合にサブクラス化し、オーバーライドします。
 void install(JFormattedTextField ftf)
          AbstractFormatter を特定の JFormattedTextField にインストールします。
protected  void invalidEdit()
          これはユーザーが不正な文字を入力したときに呼び出されます。
protected  void setEditValid(boolean valid)
          JFormattedTextFieldeditValid プロパティーを更新するために呼び出します。
abstract  Object stringToValue(String text)
          任意のオブジェクトを返す text の構文を解析します。
 void uninstall()
          JFormattedTextField にインストールされた、任意の状態の AbstractFormatter をアンインストールします。
abstract  String valueToString(Object value)
          value を表示するための文字列値を返します。
 
クラス java.lang.Object から継承されたメソッド
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

JFormattedTextField.AbstractFormatter

public JFormattedTextField.AbstractFormatter()
メソッドの詳細

install

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

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

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

これは public メソッドですが、通常は JFormattedTextField のサブクラスに対してだけ有効です。値が変更されるか、内部状態が変更される場合、JFormattedTextField によりこのメソッドが呼び出されます。ユーザー自身が呼び出す必要があるのは、JFormattedTextField をサブクラス化している場合、および AbstractFormatterJFormattedTextField とは異なるタイミングでインストールまたはアンインストールしている場合だけです。

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

uninstall

public void uninstall()
JFormattedTextField にインストールされた、任意の状態の AbstractFormatter をアンインストールします。JFormattedTextField にインストールされた DocumentFilterNavigationFilter、および追加 Action がリセットされます。


stringToValue

public abstract Object stringToValue(String text)
                              throws ParseException
任意のオブジェクトを返す text の構文を解析します。フォーマッタによっては null が返されます。

パラメータ:
text - 変換対象の文字列
戻り値:
テキストのオブジェクト表現
例外:
ParseException - 変換でエラーが発生した場合

valueToString

public abstract String valueToString(Object value)
                              throws ParseException
value を表示するための文字列値を返します。

パラメータ:
value - 変換対象の値
戻り値:
値の文字列表現
例外:
ParseException - 変換でエラーが発生した場合

getFormattedTextField

protected JFormattedTextField getFormattedTextField()
AbstractFormatter がインストールされている現在の JFormattedTextField を返します。

戻り値:
フォーマット対象の JFormattedTextField

invalidEdit

protected void invalidEdit()
これはユーザーが不正な文字を入力したときに呼び出されます。呼び出しを現在の JFormattedTextField に転送します。


setEditValid

protected void setEditValid(boolean valid)
JFormattedTextFieldeditValid プロパティーを更新するために呼び出します。JFormattedTextField が常に有効な状態であるようにポロシーを強化している場合は、呼び出す必要はありません。

パラメータ:
valid - JformattedTextField の有効な状態

getActions

protected Action[] getActions()
Action のカスタムセットを提供する場合は、サブクラス化してオーバーライドします。install により、JFormattedTextFieldActionMap にインストールされます。

戻り値:
JformattedTextField にインストールするアクションの配列

getDocumentFilter

protected DocumentFilter getDocumentFilter()
入力を制限する DocumentFilter を提供する場合は、サブクラス化し、オーバーライドします。install は、戻り値を JFormattedTextField にインストールします。

戻り値:
編集を制限する DocumentFilter

getNavigationFilter

protected NavigationFilter getNavigationFilter()
ユーザーのナビゲート先を制限するフィルタを提供する場合にサブクラス化し、オーバーライドします。install は戻り値を JFormattedTextField にインストールします。

戻り値:
ナビゲーションを制限する NavigationFilter

clone

protected Object clone()
                throws CloneNotSupportedException
AbstractFormatter を複製します。返されるインスタンスは JFormattedTextField には関連付けられません。

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

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 も参照してください。