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 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

BoundedRangeModel

字段摘要

protected ChangeEvent	changeEvent 由于事件的惟一状态（只读）为源属性，所以每个模型实例只需要一个 ChangeEvent。
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： minimum <= value <= value+extent <= maximum
void	setMaximum(int n) 在确保 n 以及其他三个属性满足以下模型约束条件之后，将 maximum 设置为 n： minimum <= value <= value+extent <= maximum
void	setMinimum(int n) 在确保 n 以及其他三个属性满足以下模型约束条件之后，将 minimum 设置为 n： minimum <= value <= value+extent <= maximum
void	setRangeProperties(int newValue, int newExtent, int newMin, int newMax, boolean adjusting) 在强行使参数满足以下常规约束条件之后，设置所有的 BoundedRangeModel 属性： minimum <= value <= value+extent <= maximum 至多生成一个 ChangeEvent。
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。这里生成的事件源总是“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。调整是错误的。如果不满足以下约束条件，则抛出 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)

在确保 n 以及其他三个属性满足以下模型约束条件之后，将 minimum 设置为 n：

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

指定者：

接口 BoundedRangeModel 中的 setMinimum

参数：

n - 模型的新 minimum

另请参见：

getMinimum(), BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)

在确保 n 以及其他三个属性满足以下模型约束条件之后，将 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。

指定者：

接口 BoundedRangeModel 中的 setRangeProperties

参数：

newValue - 给出当前值的一个 int 值

newExtent - 给出 value 可以“跳跃”的量的 int 值

newMin - 给出 minimum 值的 int 值

newMax - 给出 maximum 值的 int 值

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。每当任何一个 Bounded Range 模型属性发生更改时，更改侦听器都会运行。

指定者：

接口 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 <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回当前已在此模型上注册为 FooListener 的所有对象组成的数组。FooListener 是用 addFooListener 方法注册的。

可以使用 class 字面值来指定 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()