java.lang.Object javax.swing.DefaultBoundedRangeModel
public class DefaultBoundedRangeModel
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() 运行每个 ChangeListener 的 stateChanged 方法。 |
|
ChangeListener[] |
getChangeListeners() 返回此 DefaultBoundedRangeModel 上所有已注册的更改侦听器组成的数组。 |
|
int |
getExtent() 返回模型的 extent。 |
|
|
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 |
字段详细信息 |
---|
protected transient ChangeEvent changeEvent
ChangeEvent
。这里生成的事件源总是“this”。
protected EventListenerList listenerList
构造方法详细信息 |
---|
public DefaultBoundedRangeModel()
value
= 0 extent
= 0 minimum
= 0 maximum
= 100 adjusting
= false
public DefaultBoundedRangeModel(int value, int extent, int min, int max)
IllegalArgumentException
:
min <= value <= value+extent <= max
方法详细信息 |
---|
public int getValue()
BoundedRangeModel
中的
getValue
setValue(int)
,
BoundedRangeModel.getValue()
public int getExtent()
BoundedRangeModel
中的
getExtent
setExtent(int)
,
BoundedRangeModel.getExtent()
public int getMinimum()
BoundedRangeModel
中的
getMinimum
setMinimum(int)
,
BoundedRangeModel.getMinimum()
public int getMaximum()
BoundedRangeModel
中的
getMaximum
setMaximum(int)
,
BoundedRangeModel.getMaximum()
public void setValue(int n)
minimum <= value <= value+extent <= maximum
BoundedRangeModel
中的
setValue
n
- 模型的新值
BoundedRangeModel.setValue(int)
public void setExtent(int n)
minimum <= value <= value+extent <= maximum
BoundedRangeModel
中的
setExtent
n
- 模型的新 extent
BoundedRangeModel.setExtent(int)
public void setMinimum(int n)
minimum <= value <= value+extent <= maximum
BoundedRangeModel
中的
setMinimum
n
- 模型的新 minimum
getMinimum()
,
BoundedRangeModel.setMinimum(int)
public void setMaximum(int n)
minimum <= value <= value+extent <= maximum
BoundedRangeModel
中的
setMaximum
n
- 模型的新 maximum
BoundedRangeModel.setMaximum(int)
public void setValueIsAdjusting(boolean b)
valueIsAdjusting
属性。
BoundedRangeModel
中的
setValueIsAdjusting
b
- 如果即将进行的 value 属性更改是一系列更改的一部分,则该参数为 true
getValueIsAdjusting()
,
setValue(int)
,
BoundedRangeModel.setValueIsAdjusting(boolean)
public boolean getValueIsAdjusting()
BoundedRangeModel
中的
getValueIsAdjusting
valueIsAdjusting
属性的值
setValue(int)
,
BoundedRangeModel.getValueIsAdjusting()
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)
public void addChangeListener(ChangeListener l)
ChangeListener
。每当任何一个 Bounded Range 模型属性发生更改时,更改侦听器都会运行。
BoundedRangeModel
中的
addChangeListener
l
- 要添加的 ChangeListener
removeChangeListener(javax.swing.event.ChangeListener)
,
BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)
public void removeChangeListener(ChangeListener l)
ChangeListener
。
BoundedRangeModel
中的
removeChangeListener
l
- 要移除的
ChangeListener
addChangeListener(javax.swing.event.ChangeListener)
,
BoundedRangeModel.removeChangeListener(javax.swing.event.ChangeListener)
public ChangeListener[] getChangeListeners()
DefaultBoundedRangeModel
上所有已注册的更改侦听器组成的数组。
ChangeListener
,如果当前没有已注册的更改侦听器,则返回一个空数组。
addChangeListener(javax.swing.event.ChangeListener)
,
removeChangeListener(javax.swing.event.ChangeListener)
protected void fireStateChanged()
ChangeListener
的
stateChanged
方法。
public String toString()
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
的类或接口
getChangeListeners()