模块 java.desktop

包 javax.swing

类 DefaultBoundedRangeModel

java.lang.Object

javax.swing.DefaultBoundedRangeModel

所有已实现的接口：

Serializable , BoundedRangeModel

public class DefaultBoundedRangeModel extends Object implements BoundedRangeModel , Serializable 
      

BoundedRangeModel 的通用实现。

Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始，对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。

自从：

1.2

参见：

• BoundedRangeModel

字段摘要

字段

修饰符和类型	Field	描述
protected ChangeEvent	changeEvent	每个模型实例只需要一个 ChangeEvent，因为事件的唯一（只读）状态是源属性。
protected EventListenerList	listenerList	等待模型更改的监听。

构造方法总结

构造方法

构造方法	描述
DefaultBoundedRangeModel()	使用默认值初始化所有属性。
DefaultBoundedRangeModel(int value, int extent, int min, int max)	初始化值、范围、最小值和最大值。

方法总结

修饰符和类型	方法	描述
void	addChangeListener(ChangeListener l)	添加一个 ChangeListener 。
protected void	fireStateChanged()	运行每个 ChangeListener 的 stateChanged 方法。
ChangeListener[]	getChangeListeners()	返回在此 DefaultBoundedRangeModel 上注册的所有更改监听器的数组。
int	getExtent()	返回模型的范围。
<T extends EventListener> T[]	getListeners(Class<T> listenerType)	返回当前在此模型上注册为 FooListener 的所有对象的数组。
int	getMaximum()	返回模型的最大值。
int	getMinimum()	返回模型的最小值。
int	getValue()	返回模型的当前值。
boolean	getValueIsAdjusting()	如果该值由于用户采取的操作而处于更改过程中，则返回 true。
void	removeChangeListener(ChangeListener l)	删除 ChangeListener 。
void	setExtent(int n)	将范围设置为n确保之后n大于或等于零并且在模型的约束范围内：
void	setMaximum(int n)	将最大值设置为n确保之后n其他三个属性服从模型的约束：
void	setMinimum(int n)	将最小值设置为n确保之后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，因为事件的唯一（只读）状态是源属性。这里产生的事件源总是“this”。

listenerList

protected EventListenerList  listenerList
            

等待模型更改的监听。

构造方法详细信息

DefaultBoundedRangeModel

public DefaultBoundedRangeModel()
            

使用默认值初始化所有属性。这些值是：

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

DefaultBoundedRangeModel

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

初始化值、范围、最小值和最大值。调整是错误的。如果不满足以下约束，则抛出 IllegalArgumentException：

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

参数：

value - 一个给出当前值的整数

extent - 从模型值开始的内部范围的长度

min - 给出最小值的整数

max - 一个给出最大值的整数

方法详情

getValue

public int getValue()
            

返回模型的当前值。

指定者：

getValue 在接口 BoundedRangeModel 中

返回：

模型的当前值

参见：

• setValue(int)
• BoundedRangeModel.getValue()

getExtent

public int getExtent()
            

返回模型的范围。

指定者：

getExtent 在接口 BoundedRangeModel 中

返回：

模型的范围

参见：

• setExtent(int)
• BoundedRangeModel.getExtent()

getMinimum

public int getMinimum()
            

返回模型的最小值。

指定者：

getMinimum 在接口 BoundedRangeModel 中

返回：

模型的最小值

参见：

• setMinimum(int)
• BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()
            

返回模型的最大值。

指定者：

getMaximum 在接口 BoundedRangeModel 中

返回：

模型的最大值

参见：

• 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确保之后n大于或等于零并且在模型的约束范围内：

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

指定者：

setExtent 在接口 BoundedRangeModel 中

参数：

n - 模型的新范围

参见：

• BoundedRangeModel.setExtent(int)

setMinimum

public void setMinimum(int n)
            

将最小值设置为n确保之后n其他三个属性服从模型的约束：

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

指定者：

setMinimum 在接口 BoundedRangeModel 中

参数：

n - 模型的新最小值

参见：

• getMinimum()
• BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)
            

将最大值设置为n确保之后n其他三个属性服从模型的约束：

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

指定者：

setMaximum 在接口 BoundedRangeModel 中

参数：

n - 模型的新最大值

参见：

• BoundedRangeModel.setMaximum(int)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)
            

设置 valueIsAdjusting 属性。

指定者：

setValueIsAdjusting 在接口 BoundedRangeModel 中

参数：

b - 如果即将对 value 属性进行的更改是一系列的一部分，则为真

参见：

• 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。

指定者：

setRangeProperties 在接口 BoundedRangeModel 中

参数：

newValue - 一个给出当前值的整数

newExtent - 一个整数，给出值可以“跳跃”的量

newMin - 一个给出最小值的整数

newMax - 一个给出最大值的整数

adjusting - boolean，如果正在进行一系列更改则为真

参见：

• 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 模型属性中的任何一个发生更改时，都会运行更改监听器。

指定者：

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 s 或空数组（如果当前未注册更改监听器）

自从：

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 方法注册的。

您可以使用类文字指定 listenerType 参数，例如 FooListener.class 。例如，您可以使用以下代码查询 DefaultBoundedRangeModel 实例 m 的更改监听器：

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

如果不存在这样的监听器，则此方法返回一个空数组。

类型参数：

T - 被请求的 EventListener 类的类型

参数：

listenerType - 请求的监听器类型；此参数应指定从 java.util.EventListener 派生的接口

返回：

在此模型上注册为 FooListener 的所有对象的数组，如果没有添加此类监听器，则为空数组

抛出：

ClassCastException - 如果 listenerType 没有指定实现 java.util.EventListener 的类或接口

自从：

1.3

参见：

• getChangeListeners()