Java javax.swing 类 JSpinner（JDK5）

所有类

javax.swing
类 JSpinner

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JSpinner

所有已实现的接口：

ImageObserver, MenuContainer, Serializable, Accessible

public class JSpinner
   
   
   
   
extends JComponent
   
   
   
   
   
   
   
   
implements Accessible
   
   
   
   

让用户从一个有序序列中选择一个数字或者一个对象值的单行输入字段。Spinner 通常提供一对带小箭头的按钮以便逐步遍历序列元素。键盘的向上/向下方向键也可循环遍历元素。也允许用户在 spinner 中直接输入合法值。尽管组合框提供了相似的功能，但因为 spinner 不要求可隐藏重要数据的下拉列表，所以有时它也成为首要选择。

JSpinner 序列的值由其 SpinnerModel 定义。此 model 可指定为构造方法的参数，并且可通过 model 属性进行更改。提供了针对某些常见类型的 SpinnerModel 类：SpinnerListModel、SpinnerNumberModel 和 SpinnerDateModel。

JSpinner 具有一个负责显示和潜在地更改当前元素或者模型 value 的惟一子组件，被称为 editor。此编辑器由 JSpinner 的构造方法创建，并且可通过 editor 属性进行更改。JSpinner 的编辑器通过侦听 ChangeEvent 而与模型保持同步。如果用户更改了 editor 所显示的值，则有可能 model 的值与 editor 的值不一样。为保证 model 与编辑器具有相同的值，请使用 commitEdit 方法，例如：

   try {
       spinner.commitEdit();
   }
   catch (ParseException pe) {{
       // Edited value is invalid, spinner.getValue() will return
       // the last valid value, you could revert the spinner to show that:
       JComponent editor = spinner.getEditor()
       if (editor instanceof DefaultEditor) {
           ((DefaultEditor)editor).getTextField().setValue(spinner.getValue();
       }
       // reset the value to some known value:
       spinner.setValue(fallbackValue);
       // or treat the last valid value as the current, in which
       // case you don't need to do anything.
   }
   return spinner.getValue();
 

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

从以下版本开始：

1.4

另请参见：

SpinnerModel, AbstractSpinnerModel, SpinnerListModel, SpinnerNumberModel, SpinnerDateModel, JFormattedTextField

JSpinner

public JSpinner(SpinnerModel model)

构造具有一对 next/previous 按钮和 SpinnerModel 编辑器的完整 spinner。

JSpinner

public JSpinner()

构造一个 spinner，使其具有初始值为 0 并且无任何最小值或者最大值限制的 Integer SpinnerNumberModel。

getUI

public SpinnerUI getUI()

返回呈现此组件的外观 (L&F) 对象。

返回：

呈现此组件的 SpinnerUI 对象

setUI

public void setUI(SpinnerUI ui)

设置呈现此组件的外观 (L&F) 对象。

参数：

ui - SpinnerUI L&F 对象

另请参见：

UIDefaults.getUI(javax.swing.JComponent)

getUIClassID

public String getUIClassID()

返回用于构造呈现此组件外观 (L&F) 类的名称的后缀。

覆盖：

类 JComponent 中的 getUIClassID

返回：

字符串 "SpinnerUI"

另请参见：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

用取自当前外观的值重设 UI 属性。

覆盖：

类 JComponent 中的 updateUI

另请参见：

UIManager.getUI(javax.swing.JComponent)

createEditor

protected JComponent createEditor(SpinnerModel model)

此方法由构造方法调用，以创建显示序列当前值的 JComponent。编辑器也可能允许用户直接输入序列中的元素。编辑器必须侦听 model 上的 ChangeEvents，并且让显示的值与模型的值保持同步。

子类可能重写此方法以便添加对新 SpinnerModel 类的支持。作为一种选择，用户可只替换此处使用 setEditor 方法创建的编辑器。从模型类型到编辑器的默认映射是：

• SpinnerNumberModel => JSpinner.NumberEditor
• SpinnerDateModel => JSpinner.DateEditor
• SpinnerListModel => JSpinner.ListEditor
• all others => JSpinner.DefaultEditor

参数：

model - getModel 的值

返回：

显示序列当前值的组件

另请参见：

getModel(), setEditor(javax.swing.JComponent)

setModel

public void setModel(SpinnerModel model)

更改表示此 spinner 值的模型。如果没有显示地设置编辑器属性，将在调用 "model" 的 PropertyChangeEvent 后（隐式地）设置编辑器属性。编辑器属性设置为 createEditor 所返回的值，如：

 setEditor(createEditor(model));
 

参数：

model - 新的 SpinnerModel

抛出：

IllegalArgumentException - 如果 model 为 null

另请参见：

getModel(), getEditor(), setEditor(javax.swing.JComponent)