javax.swing
クラス DefaultBoundedRangeModel

java.lang.Object
  |
  +--javax.swing.DefaultBoundedRangeModel

すべての実装インタフェース:

BoundedRangeModel, Serializable

public class DefaultBoundedRangeModel

extends Object

implements BoundedRangeModel, Serializable

BoundedRangeModel の汎用実装です。

警告: このクラスの直列化オブジェクトは今後リリースされる Swing との互換性はありません。現在サポートされている直列化は、短期間の保管、または同じバージョンの Swing が稼働しているアプリケーション間の RMI に適しています。1.4 からは、すべての JavaBeans^TM の長期間の保管が java.beans パッケージで追加サポートされています。XMLEncoder を参照してください。

関連項目:

BoundedRangeModel

フィールドの概要

protected ChangeEvent	changeEvent イベントは読み取り専用で、常にソースプロパティの状態であるため、必要な ChangeEvent の数はモデルインスタンスごとに 1 つです。
protected EventListenerList	listenerList モデル変更を待っているリスナーです。

コンストラクタの概要

DefaultBoundedRangeModel()
デフォルト値ですべてのプロパティを初期化します。

DefaultBoundedRangeModel(int value, int extent, int min, int max)
value、extent、minimum、および maximum を初期化します。

メソッドの概要

void	addChangeListener(ChangeListener l) ChangeListener を追加します。
protected void	fireStateChanged() 各 ChangeListener の stateChanged メソッドを実行します。
ChangeListener[]	getChangeListeners() DefaultBoundedRangeModel に登録されているすべての変更リスナーの配列を返します。
int	getExtent() モデルの extent を返します。
EventListener[]	getListeners(Class listenerType) このモデルに FooListener として現在登録されているすべてのオブジェクトの配列を返します。
int	getMaximum() モデルの maximum を返します。
int	getMinimum() モデルの minimum を返します。
int	getValue() モデルの現在の値を返します。
boolean	getValueIsAdjusting() ユーザがアクションを取得中であるために値の変更が進行している場合に、true を返します。
void	removeChangeListener(ChangeListener l) ChangeListener を削除します。
void	setExtent(int n) n がゼロより大きいか等しく、モデルの制約内に収まることを確認したあと、extent を n に設定します。
void	setMaximum(int n) ほかの 3 つのプロパティがモデルの制約に従うことを確認したあと、maximum を n に設定します。
void	setMinimum(int n) ほかの 3 つのプロパティがモデルの制約に従うことを確認したあと、minimum を n に設定します。
void	setRangeProperties(int newValue, int newExtent, int newMin, int newMax, boolean adjusting) 引数を通常の制約内の値に強制的に設定したあとで、BoundedRangeModel プロパティのすべてを設定します。
void	setValue(int n) モデルの現在の値を設定します。
void	setValueIsAdjusting(boolean b) valueIsAdjusting プロパティを設定します。
String	toString() すべての BoundedRangeModel プロパティを表示する文字列を返します。

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

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

フィールドの詳細

changeEvent

protected transient ChangeEvent changeEvent

イベントは読み取り専用で、常にソースプロパティの状態であるため、必要な ChangeEvent の数はモデルインスタンスごとに 1 つです。ここで生成されるイベントのソースは、常に「this」です。

listenerList

protected EventListenerList listenerList

モデル変更を待っているリスナーです。

コンストラクタの詳細

DefaultBoundedRangeModel

public DefaultBoundedRangeModel()

デフォルト値ですべてのプロパティを初期化します。次にデフォルト値を示します。

• value = 0
• extent = 0
• minimum = 0
• maximum = 100
• adjusting = false

DefaultBoundedRangeModel

public DefaultBoundedRangeModel(int value,
                                int extent,
                                int min,
                                int max)

value、extent、minimum、および maximum を初期化します。adjusting は false に設定されます。次の制約内に収まらない場合は IllegalArgumentException をスローします。

min <= value <= value+extent <= max

メソッドの詳細

getValue

public int getValue()

モデルの現在の値を返します。

定義:

インタフェース BoundedRangeModel 内の getValue

戻り値:

モデルの現在の値

関連項目:

setValue(int), BoundedRangeModel.getValue()

getExtent

public int getExtent()

モデルの extent を返します。

定義:

インタフェース BoundedRangeModel 内の getExtent

戻り値:

モデルの extent

関連項目:

setExtent(int), BoundedRangeModel.getExtent()

getMinimum

public int getMinimum()

モデルの minimum を返します。

定義:

インタフェース BoundedRangeModel 内の getMinimum

戻り値:

モデルの minimum

関連項目:

setMinimum(int), BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()

モデルの maximum を返します。

定義:

インタフェース BoundedRangeModel 内の getMaximum

戻り値:

モデルの maximum

関連項目:

setMaximum(int), BoundedRangeModel.getMaximum()

setValue

public void setValue(int n)

モデルの現在の値を設定します。これは、ノブの表示位置を指定するスライダに対して設定されます。新しい値 n は確実にモデルの制約内に収まります。

minimum <= value <= value+extent <= maximum

定義:

インタフェース BoundedRangeModel 内の setValue

パラメータ:

n - モデルの新しい値

関連項目:

BoundedRangeModel.setValue(int)

setExtent

public void setExtent(int n)

n がゼロより大きいか等しく、モデルの制約内に収まることを確認したあと、extent を n に設定します。

minimum <= value <= value+extent <= maximum

定義:

インタフェース BoundedRangeModel 内の setExtent

パラメータ:

n - モデルの新しい extent

関連項目:

BoundedRangeModel.setExtent(int)

setMinimum

public void setMinimum(int n)

ほかの 3 つのプロパティがモデルの制約に従うことを確認したあと、minimum を n に設定します。

minimum <= value <= value+extent <= maximum

定義:

インタフェース BoundedRangeModel 内の setMinimum

パラメータ:

n - モデルの新しい minimum

関連項目:

getMinimum(), BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)

ほかの 3 つのプロパティがモデルの制約に従うことを確認したあと、maximum を n に設定します。

minimum <= value <= value+extent <= maximum

定義:

インタフェース BoundedRangeModel 内の setMaximum

パラメータ:

n - モデルの新しい maximum

関連項目:

BoundedRangeModel.setMaximum(int)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

valueIsAdjusting プロパティを設定します。

定義:

インタフェース BoundedRangeModel 内の setValueIsAdjusting

パラメータ:

b - value プロパティへの変更を、一連の変更の一部とする場合は true

関連項目:

getValueIsAdjusting(), setValue(int), BoundedRangeModel.setValueIsAdjusting(boolean)

getValueIsAdjusting

public boolean getValueIsAdjusting()

ユーザがアクションを取得中であるために値の変更が進行している場合に、true を返します。

定義:

インタフェース BoundedRangeModel 内の getValueIsAdjusting

戻り値:

valueIsAdjusting プロパティの値

関連項目:

setValue(int), BoundedRangeModel.getValueIsAdjusting()

setRangeProperties

public void setRangeProperties(int newValue,
                               int newExtent,
                               int newMin,
                               int newMax,
                               boolean adjusting)

引数を通常の制約内の値に強制的に設定したあとで、BoundedRangeModel プロパティのすべてを設定します。

minimum <= value <= value+extent <= maximum

生成される ChangeEvent は多くても 1 つだけです。

定義:

インタフェース BoundedRangeModel 内の setRangeProperties

パラメータ:

newValue - 現在の値を指定する整数値

newExtent - 値が「ジャンプ」できる量を指定する整数値

newMin - 最小値を指定する整数値

newMax - 最大値を指定する整数値

関連項目:

BoundedRangeModel.setRangeProperties(int, int, int, int, boolean), setValue(int), setExtent(int), setMinimum(int), setMaximum(int), setValueIsAdjusting(boolean)

addChangeListener

public void addChangeListener(ChangeListener l)

ChangeListener を追加します。変更リスナーは、BoundedRangeModel プロパティのどれか 1 つが変更されるたびに実行されます。

定義:

インタフェース BoundedRangeModel 内の addChangeListener

パラメータ:

l - 追加する ChangeListener

関連項目:

removeChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

ChangeListener を削除します。

定義:

インタフェース BoundedRangeModel 内の removeChangeListener

パラメータ:

l - 削除する ChangeListener

関連項目:

addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.removeChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()

DefaultBoundedRangeModel に登録されているすべての変更リスナーの配列を返します。

戻り値:

このボタンのすべての ChangeListener。変更リスナーが現在登録されていない場合は空の配列を返す

導入されたバージョン:

1.4

関連項目:

addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()

各 ChangeListener の stateChanged メソッドを実行します。

関連項目:

setRangeProperties(int, int, int, int, boolean), EventListenerList

toString

public String toString()

すべての BoundedRangeModel プロパティを表示する文字列を返します。

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現

getListeners

public EventListener[] getListeners(Class listenerType)

このモデルに FooListener として現在登録されているすべてのオブジェクトの配列を返します。この FooListener は addFooListener メソッドで登録されたものです。

listenerType 引数は FooListener.class のようなクラスリテラルで指定できます。たとえば、この変更リスナーに対する DefaultBoundedRangeModel インスタンス m の照会は次のコードで行います。

ChangeListener[] cls = (ChangeListener[])(m.getListeners(ChangeListener.class));

このようなリスナーがない場合は、空の配列を返します。

パラメータ:

listenerType - 要求されるリスナーのタイプ。java.util.EventListener の下位インタフェースを指定

戻り値:

このモデルに FooListener として登録されているすべてのオブジェクトの配列。リスナーが登録されていない場合は、空の配列を返す

例外:

ClassCastException - listenerType が java.util.EventListener を実装するクラスまたはインタフェースを指定しない場合

導入されたバージョン:

1.3

関連項目:

getChangeListeners()