JavaTM Platform
Standard Ed. 6

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 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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()
          运行每个 ChangeListenerstateChanged 方法。
 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)
          在确保 n 以及其他三个属性满足以下模型约束条件之后,将 maximum 设置为 n
 void setMinimum(int n)
          在确保 n 以及其他三个属性满足以下模型约束条件之后,将 minimum 设置为 n
 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()
使用默认值初始化所有属性。这些值是:


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()
运行每个 ChangeListenerstateChanged 方法。

另请参见:
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()

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策