モジュール java.desktop

パッケージ javax.swing

クラスDefaultBoundedRangeModel

java.lang.Object

javax.swing.DefaultBoundedRangeModel

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

Serializable, BoundedRangeModel

public class DefaultBoundedRangeModel extends Object implements BoundedRangeModel, Serializable

BoundedRangeModelのジェネリック実装です。

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

導入されたバージョン:

1.2

関連項目:

• 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を返します。
<T extends EventListener> T[]	getListeners(Class<T> 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
 

パラメータ:

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

extent - モデルの値から始まる内部範囲の長さ

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

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

メソッドの詳細

getValue

public int getValue()

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

定義:

getValue、インタフェースBoundedRangeModel

戻り値:

モデルの現在の値

関連項目:

• setValue(int)
• BoundedRangeModel.getValue()

getExtent

public int getExtent()

モデルのextentを返します。

定義:

getExtent、インタフェースBoundedRangeModel

戻り値:

モデルのextent

関連項目:

• setExtent(int)
• BoundedRangeModel.getExtent()

getMinimum

public int getMinimum()

モデルのminimumを返します。

定義:

getMinimum、インタフェースBoundedRangeModel

戻り値:

モデルのminimum

関連項目:

• setMinimum(int)
• BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()

モデルのmaximumを返します。

定義:

getMaximum、インタフェースBoundedRangeModel

戻り値:

モデルのmaximum

関連項目:

• setMaximum(int)
• BoundedRangeModel.getMaximum()

setValue

public void setValue(int n)

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

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

定義:

setValue、インタフェースBoundedRangeModel

パラメータ:

n - モデルの新しい値

関連項目:

• BoundedRangeModel.setValue(int)

setExtent

public void setExtent(int n)

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

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

定義:

setExtent、インタフェースBoundedRangeModel

パラメータ:

n - モデルの新しいextent

関連項目:

• BoundedRangeModel.setExtent(int)

setMinimum

public void setMinimum(int n)

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

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

定義:

setMinimum、インタフェースBoundedRangeModel

パラメータ:

n - モデルの新しいminimum

関連項目:

• getMinimum()
• BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)

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

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

定義:

setMaximum、インタフェースBoundedRangeModel

パラメータ:

n - モデルの新しいmaximum

関連項目:

• BoundedRangeModel.setMaximum(int)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

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

定義:

setValueIsAdjusting、インタフェースBoundedRangeModel

パラメータ:

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

関連項目:

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

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

定義:

getValueIsAdjusting、インタフェースBoundedRangeModel

戻り値:

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つだけです。

定義:

setRangeProperties、インタフェースBoundedRangeModel

パラメータ:

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

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

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

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

adjusting - boolean値。一連の変更が進行中である場合はtrue

関連項目:

• 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つが変更されるたびに実行されます。

定義:

addChangeListener、インタフェースBoundedRangeModel

パラメータ:

l - 追加するChangeListener

関連項目:

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

ChangeListenerを削除します。

定義:

removeChangeListener、インタフェースBoundedRangeModel

パラメータ:

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プロパティを表示する文字列を返します。

オーバーライド:

toString、クラスObject

戻り値:

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

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

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

FooListener.classなどのクラス・リテラルを使用してlistenerType引数を指定できます。 たとえば、次のコードを使用すると、この変更リスナーのDefaultBoundedRangeModelインスタンスmを照会できます。

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

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

型パラメータ:

T - EventListenerクラスの型がリクエストされています

パラメータ:

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

戻り値:

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

例外:

ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった場合

導入されたバージョン:

1.3

関連項目:

• getChangeListeners()