模块 java.desktop

包 javax.swing

类 SpinnerListModel

java.lang.Object

javax.swing.AbstractSpinnerModel

javax.swing.SpinnerListModel

所有已实现的接口：

Serializable , SpinnerModel

public class SpinnerListModel extends AbstractSpinnerModel implements Serializable 
      

SpinnerModel 的简单实现，其值由数组或 List 定义。例如，要创建一个由星期几的名称数组定义的模型：

 String[] days = new DateFormatSymbols().getWeekdays();
 SpinnerModel model = new SpinnerListModel(Arrays.asList(days).subList(1, 8));
 

此类仅存储对数组或 List 的引用，因此如果基础序列的元素发生变化，则由应用程序通知ChangeListeners 通过调用 fireStateChanged。

这个模型继承了一个ChangeListener。只要模型的 value 或 list 属性发生变化，就会通知 ChangeListener s。

自从：

1.4

参见：

• JSpinner
• SpinnerModel
• AbstractSpinnerModel
• SpinnerNumberModel
• SpinnerDateModel

字段摘要

在类 javax.swing.AbstractSpinnerModel 中声明的字段

listenerList

构造方法总结

构造方法

构造方法	描述
SpinnerListModel()	构造一个有效的空 SpinnerListModel 。
SpinnerListModel(Object[] values)	构造一个 SpinnerModel，其值序列由指定数组定义。
SpinnerListModel(List<?> values)	构造一个 SpinnerModel ，其值序列由指定的 List 定义。

方法总结

修饰符和类型	方法	描述
List<?>	getList()	返回定义此模型序列的 List。
Object	getNextValue()	返回底层序列的下一个合法值，如果值已经是最后一个元素，则返回 null。
Object	getPreviousValue()	返回基础序列的前一个元素，如果值已经是第一个元素，则返回 null。
Object	getValue()	返回序列的当前元素。
void	setList(List<?> list)	更改定义此序列的列表并将模型 value 的索引重置为零。
void	setValue(Object elt)	更改序列的当前元素并通知 ChangeListeners 。

在类 javax.swing.AbstractSpinnerModel 中声明的方法

addChangeListener, fireStateChanged, getChangeListeners, getListeners, removeChangeListener

在类 java.lang.Object 中声明的方法

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

构造方法详细信息

SpinnerListModel

public SpinnerListModel(List <?> values)
            

构造一个 SpinnerModel ，其值序列由指定的 List 定义。初始值（当前元素) 的模型将是 values.get(0) 。如果 values 是 null 或大小为零，则抛出 IllegalArugmentException。

参数：

values - 这个模型代表的序列

抛出：

IllegalArgumentException - 如果 values 是 null 或零大小

SpinnerListModel

public SpinnerListModel(Object [] values)
            

构造一个 SpinnerModel，其值序列由指定数组定义。模型的初始值为 values[0]。如果 values 是 null 或长度为零，则抛出 IllegalArgumentException。

参数：

values - 这个模型代表的序列

抛出：

IllegalArgumentException - 如果 values 是 null 或零长度

SpinnerListModel

public SpinnerListModel()
            

构造一个有效的空 SpinnerListModel 。该模型的列表将包含一个 "empty" 字符串元素。

方法详情

getList

public List <?> getList()
            

返回定义此模型序列的 List。

返回：

list 属性的值

参见：

• setList(java.util.List<?>)

setList

public void setList(List <?> list)
            

更改定义此序列的列表并将模型 value 的索引重置为零。请注意，list 未被复制，模型仅存储对它的引用。

如果 list 不等于当前列表，此方法将触发 ChangeEvent。

参数：

list - 此模型表示的序列

抛出：

IllegalArgumentException - 如果 list 是 null 或零长度

参见：

• getList()

getValue

public Object  getValue()
            

返回序列的当前元素。

指定者：

getValue 在接口 SpinnerModel 中

返回：

value 属性

参见：

• SpinnerModel.getValue()
• setValue(java.lang.Object)

setValue

public void setValue(Object  elt)
            

更改序列的当前元素并通知 ChangeListeners 。如果指定值不等于底层序列的元素，则抛出 IllegalArgumentException。在以下示例中，setValue 调用将引发异常：

 String[] values = {"one", "two", "free", "four"};
 SpinnerModel model = new SpinnerListModel(values);
 model.setValue("TWO");
 

指定者：

setValue 在接口 SpinnerModel 中

参数：

elt - 将成为模型当前值的序列元素

抛出：

IllegalArgumentException - 如果不允许指定值

参见：

• SpinnerModel.setValue(java.lang.Object)
• getValue()

getNextValue

public Object  getNextValue()
            

返回底层序列的下一个合法值，如果值已经是最后一个元素，则返回 null。

指定者：

getNextValue 在接口 SpinnerModel 中

返回：

底层序列的下一个合法值或 null 如果值已经是最后一个元素

参见：

• SpinnerModel.getNextValue()
• getPreviousValue()

getPreviousValue

public Object  getPreviousValue()
            

返回基础序列的前一个元素，如果值已经是第一个元素，则返回 null。

指定者：

getPreviousValue 在接口 SpinnerModel 中

返回：

基础序列的前一个元素或 null 如果值已经是第一个元素

参见：

• SpinnerModel.getPreviousValue()
• getNextValue()