Module java.desktop

Package javax.swing

Class 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

Field Summary

Fields

Modifier and Type	Field	Description
protected ChangeEvent	changeEvent	每个模型实例只需要一个ChangeEvent，因为事件的唯一（只读）状态是源属性。
protected EventListenerList	listenerList	等待模型更改的侦听器。

Constructor Summary

Constructors

Constructor	Description
DefaultBoundedRangeModel()	使用默认值初始化所有属性。
DefaultBoundedRangeModel(int value, int extent, int min, int max)	初始化值、范围、最小值和最大值。

Method Summary

Modifier and Type	Method	Description
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，确保其他三个属性遵守模型的约束：
void	setMinimum(int 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属性的字符串。

Methods declared in class java.lang.Object

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

Field Details

changeEvent

             protected transient ChangeEvent changeEvent
            

每个模型实例只需要一个ChangeEvent，因为事件的唯一（只读）状态是源属性。此处生成的事件的源始终为"this"。

listenerList

             protected EventListenerList listenerList
            

等待模型更改的侦听器。

Constructor Details

DefaultBoundedRangeModel

             public DefaultBoundedRangeModel()
            

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

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

DefaultBoundedRangeModel

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

初始化值、范围、最小值和最大值。调整为false。如果以下约束条件不满足，则抛出IllegalArgumentException：

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

参数:

value - 一个int，表示当前值

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

min - 一个int，表示最小值

max - 一个int，表示最大值

Method Details

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，确保其他三个属性遵守模型的约束范围：

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

指定者:

setMinimum 在接口 BoundedRangeModel中

参数:

n - 模型的新最小值

参见:

• getMinimum()
• BoundedRangeModel.setMinimum(int)

setMaximum

             public void setMaximum(int n)
            

将最大值设置为n，确保其他三个属性遵守模型的约束范围：

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

指定者:

setMaximum 在接口 BoundedRangeModel中

参数:

n - 模型的新最大值

参见:

• BoundedRangeModel.setMaximum(int)

setValueIsAdjusting

             public void setValueIsAdjusting(boolean b)
            

设置valueIsAdjusting属性。

指定者:

setValueIsAdjusting 在接口 BoundedRangeModel中

参数:

b - 如果值属性的即将发生的更改是一系列操作的一部分，则为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属性，强制参数遵守通常的约束条件：

     最小值 <= 值 <= 值+增量 <= 最大值
 

最多生成一个ChangeEvent。

指定者：

setRangeProperties 在接口 BoundedRangeModel

参数：

newValue - 一个int值，表示当前值

newExtent - 一个int值，表示值可以“跳跃”的量

newMin - 一个int值，表示最小值

newMax - 一个int值，表示最大值

adjusting - 一个布尔值，如果一系列更改正在进行中，则为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模型的任何一个属性更改时，都会运行更改侦听器。

指定者：

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

您可以使用类文字指定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()