java.lang.Objectjavax.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()