当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

SpinnerListModel (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

javax.swing
类 SpinnerListModel

java.lang.Object
  javax.swing.AbstractSpinnerModel
      javax.swing.SpinnerListModel

所有已实现的接口：

Serializable, SpinnerModel

---

public class SpinnerListModel
extends AbstractSpinnerModel
implements Serializable

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

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

此类只存储对该数组或 List 的引用，所以，如果基础序列的元素发生变化，则应用程序有责任通过调用 fireStateChanged 通知 ChangeListeners。

此模型继承的是一个 ChangeListener。每当该模型的 value 或 list 属性发生变化时，就会通知 ChangeListener。

从以下版本开始：

1.4

另请参见：

JSpinner, SpinnerModel, AbstractSpinnerModel, SpinnerNumberModel, SpinnerDateModel

---

字段摘要

 

从类 javax.swing.AbstractSpinnerModel 继承的字段
listenerList

 

构造方法摘要
SpinnerListModel()           创建一个实际为空的 SpinnerListModel。
SpinnerListModel(List<?> values)           构造一个由指定 List 定义其值序列的 SpinnerModel。
SpinnerListModel(Object[] values)           构造一个由指定数组定义其值序列的 SpinnerModel。

 

方法摘要
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)

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

参数：

values - 此模型表示的序列

抛出：

IllegalArugmentException - 如果 values 为 null 或零大小

---

SpinnerListModel

public SpinnerListModel(Object[] values)

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

参数：

values - 此模型表示的序列

抛出：

IllegalArugmentException - 如果 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()

返回该序列的当前元素。

指定者：

接口 SpinnerModel 中的 getValue

返回：

该 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");
 

指定者：

接口 SpinnerModel 中的 setValue

参数：

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

抛出：

IllegalArgumentException - 如果不允许指定值

另请参见：

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

---

getNextValue

public Object getNextValue()

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

指定者：

接口 SpinnerModel 中的 getNextValue

返回：

该基础序列的下一个合法值，或返回 null 如果值已经是最后一个元素

另请参见：

SpinnerModel.getNextValue(), getPreviousValue()

---

getPreviousValue

public Object getPreviousValue()

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

指定者：

接口 SpinnerModel 中的 getPreviousValue

返回：

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

另请参见：

SpinnerModel.getPreviousValue(), getNextValue()

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

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