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 をオーバーライドし、上位クラスに通知を行います。

サブクラスは変換メソッドの stringToValue と valueToString をオーバーライドする必要があります。特定の方法で getActions、getNavigationFilter、および 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) JFormattedTextField の editValid プロパティーを更新するために呼び出します。
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 からの Action、getDocumentFilter から返された DocumentFilter、getNavigationFilter から返された NavigationFilter が、JFormattedTextField にインストールされます。

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

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

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

パラメータ:

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

uninstall

public void uninstall()

JFormattedTextField にインストールされた、任意の状態の AbstractFormatter をアンインストールします。JFormattedTextField にインストールされた DocumentFilter、NavigationFilter、および追加 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)

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

パラメータ:

valid - JFormattedTextField の有効な状態

getActions

protected Action[] getActions()

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

戻り値:

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

getDocumentFilter

protected DocumentFilter getDocumentFilter()

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

戻り値:

編集を制限する DocumentFilter

getNavigationFilter

protected NavigationFilter getNavigationFilter()

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

戻り値:

ナビゲーションを制限する NavigationFilter

clone

protected Object clone()
                throws CloneNotSupportedException

AbstractFormatter を複製します。返されるインスタンスは JFormattedTextField には関連付けられません。

オーバーライド:

clone、クラス: Object

戻り値:

AbstractFormatter のコピー

例外:

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

関連項目:

Cloneable