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 を呼び出す必要があります。

コンストラクタの概要

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 から返された現在の値を文字列に変換します。次に getActions から返された Action、getDocumentFilter から返された DocumentFilter、および getNavigationFilter から返された NavigationFilter を JFormattedTextField にインストールします。

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

現在の値を文字列に変換するときに ParseException が発生した場合は、テキストとして空の文字列が設定され、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 には関連付けられません。

オーバーライド:

クラス Object 内の clone

戻り値:

AbstractFormatter のコピー

例外:

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

関連項目:

Cloneable