JSpinner (Java Platform SE 8 )

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

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible
```
public class JSpinner
extends JComponent
implements Accessible
```
单行输入字段，允许用户从有序序列中选择一个数字或一个对象值。旋转器通常提供一对微小的箭头按钮，用于逐步穿过序列的元素。键盘上/下箭头键也循环通过元素。也可以允许用户在旋转器中直接输入（合法）值。虽然组合框提供类似的功能，但有时候优选旋转器，因为它们不需要可以遮盖重要数据的下拉列表。
JSpinner的序列值由其SpinnerModel定义。该model可以被指定为构造函数的参数，并与改变model财产。 SpinnerModel提供了类的一些常见类型： SpinnerListModel ， SpinnerNumberModel和SpinnerDateModel 。

A JSpinner具有单个子组件，负责显示和潜在地更改模型的当前元素或值，这称为editor 。编辑器由JSpinner的构造函数创建，可以使用editor属性更改。 JSpinner的编辑器通过聆听ChangeEvent s与模特保持同步。如果用户已经改变由所述显示的值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(); 
```
有关使用旋转器的信息和示例，请参阅How to Use Spinners “Java教程 ”中的一节。

警告： Swing不是线程安全的。有关更多信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，支持所有JavaBeans的长期存储已经添加到java.beans包中。请参阅XMLEncoder 。
从以下版本开始：

1.4

另请参见：

SpinnerModel ， AbstractSpinnerModel ， SpinnerListModel ， SpinnerNumberModel ， SpinnerDateModel ， JFormattedTextField

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JSpinner.AccessibleJSpinner` `AccessibleJSpinner`实现 `JSpinner`类的辅助功能支持。
`static class`	`JSpinner.DateEditor` 一个 `JSpinner`的编辑器，其型号是 `SpinnerDateModel` 。
`static class`	`JSpinner.DefaultEditor` 更专业的编辑器的简单基类，用JFormattedTextField显示模型当前值的 `JFormattedTextField` 。
`static class`	`JSpinner.ListEditor` 一个 `JSpinner`为 `JSpinner`的模特是 `SpinnerListModel` 。
`static class`	`JSpinner.NumberEditor` 一个 `JSpinner`的编辑器，其型号是 `SpinnerNumberModel` 。

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary
- Fields inherited from class javax.swing.JComponent
  listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
- Fields inherited from class java.awt.Component
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`JSpinner()` 构造一个旋涂器 `Integer SpinnerNumberModel`使用初始值0并且没有最低或最高限度。
`JSpinner(SpinnerModel model)` 构造给定模型的旋转器。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addChangeListener(ChangeListener listener)` 将侦听器添加到每次发生模型更改时通知的列表。
`void`	`commitEdit()` 将当前编辑的值提交到 `SpinnerModel` 。
`protected JComponent`	`createEditor(SpinnerModel model)` 此方法由构造函数调用以创建显示序列的当前值的 `JComponent` 。
`protected void`	`fireStateChanged()` 发送一个 `ChangeEvent` ，其来源是这个 `JSpinner` ，每个 `ChangeListener` 。
`AccessibleContext`	`getAccessibleContext()` 获得 `AccessibleContext`的 `JSpinner`
`ChangeListener[]`	`getChangeListeners()` 返回使用addChangeListener（）添加到此JSpinner的所有 `ChangeListener`的数组。
`JComponent`	`getEditor()` 返回显示的组件，并可能更改模型的值。
`SpinnerModel`	`getModel()` 返回定义该旋转序列值的 `SpinnerModel` 。
`Object`	`getNextValue()` 返回 `getValue()`返回的对象后面的序列中的对象。
`Object`	`getPreviousValue()` 返回在 `getValue()`返回的对象之前的序列中的对象。
`SpinnerUI`	`getUI()` 返回渲染此组件的外观和感觉（L＆F）对象。
`String`	`getUIClassID()` 返回用于构造用于渲染此组件的外观（L＆F）类的名称的后缀。
`Object`	`getValue()` 返回模型的当前值，通常这个值由 `editor` 。
`void`	`removeChangeListener(ChangeListener listener)` 从此微调器中移除 `ChangeListener` 。
`void`	`setEditor(JComponent editor)` 更改显示 `JComponent`的当前值的 `SpinnerModel` 。
`void`	`setModel(SpinnerModel model)` 更改表示此微调器值的模型。
`void`	`setUI(SpinnerUI ui)` 设置渲染此组件的外观和感觉（L＆F）对象。
`void`	`setValue(Object value)` 更改模型的当前值，通常该值由 `editor` 。
`void`	`updateUI()` 使用当前外观的值重置UI属性。

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - JSpinner
```
public JSpinner(SpinnerModel model)
```
    构造给定模型的旋转器。微调器具有一组前一个/下一个按钮，以及适用于该模型的编辑器。
    
    异常
    
    NullPointerException - 如果型号是 null
  - JSpinner
```
public JSpinner()
```
    构造一个旋涂器 Integer SpinnerNumberModel使用初始值0并且没有最低或最高限度。
- 方法详细信息
  - 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）类的名称的后缀。
    
    重写：
    
    getUIClassID在 JComponent
    
    结果
    
    字符串“SpinnerUI”
    
    另请参见：
    
    JComponent.getUIClassID() ， UIDefaults.getUI(javax.swing.JComponent)
  - updateUI
```
public void updateUI()
```
    使用当前外观的值重置UI属性。
    
    重写：
    
    updateUI在 JComponent
    
    另请参见：
    
    UIManager.getUI(javax.swing.JComponent)
  - createEditor
```
protected JComponent createEditor(SpinnerModel model)
```
    该方法由构造函数调用来创建显示序列的当前值的JComponent 。编辑者还可以允许用户直接输入序列的元素。编辑器必须在ChangeEvents上model ，并保持其显示的值与模型的值同步。
    子类可以覆盖此方法以添加对新的SpinnerModel类的支持。或者，可以使用setEditor方法替换此处创建的编辑器。从模型类型到编辑器的默认映射是：
    - SpinnerNumberModel => JSpinner.NumberEditor
    - SpinnerDateModel => JSpinner.DateEditor
    - SpinnerListModel => JSpinner.ListEditor
    - 所有其他 => JSpinner.DefaultEditor
    参数
    
    model - getModel的值
    
    结果
    
    显示序列的当前值的组件
    
    另请参见：
    
    getModel() ， setEditor(javax.swing.JComponent)
  - setModel
```
public void setModel(SpinnerModel model)
```
    更改表示此微调器值的模型。如果编辑器属性尚未被明确设置，则编辑器属性（隐式地）设置为"model" PropertyChangeEvent已被触发。编辑器属性设置为createEditor返回的值，如：
```
  setEditor(createEditor(model)); 
```
    参数
    
    model - 全新 SpinnerModel
    
    异常
    
    IllegalArgumentException - 如果型号是 null
    
    另请参见：
    
    getModel() ， getEditor() ， setEditor(javax.swing.JComponent)
  - getModel
```
public SpinnerModel getModel()
```
    返回定义此旋转序列值的 SpinnerModel 。
    
    结果
    
    模型属性的值
    
    另请参见：
    
    setModel(javax.swing.SpinnerModel)
  - getValue
```
public Object getValue()
```
    返回模型的当前值，通常该值由editor 。如果用户已经改变由显示的值editor ，可以为model的价值，从该的不同editor ，请参阅类级别的javadoc对于如何处理这方面的例子。
    这个方法只是委托给model 。相当于：
```
  getModel().getValue() 
```
    另请参见：
    
    setValue(java.lang.Object) ， SpinnerModel.getValue()
  - setValue
```
public void setValue(Object value)
```
    更改模型的当前值，通常该值由editor 。如果SpinnerModel实现不支持指定的值，则抛出IllegalArgumentException 。
    这个方法只是委托给model 。相当于：
```
  getModel().setValue(value) 
```
    异常
    
    IllegalArgumentException - 如果 value
    
    另请参见：
    
    getValue() ， SpinnerModel.setValue(java.lang.Object)
  - getNextValue
```
public Object getNextValue()
```
    返回getValue()返回的对象后面的序列中的对象。如果序列的结尾已经到达，那么返回null 。调用此方法不影响value 。
    这个方法只是委托给model 。相当于：
```
  getModel().getNextValue() 
```
    结果
    
    下一个合法价值或 null如果不存在
    
    另请参见：
    
    getValue() ， getPreviousValue() ， SpinnerModel.getNextValue()
  - addChangeListener
```
public void addChangeListener(ChangeListener listener)
```
    将侦听器添加到每次发生模型更改时通知的列表。 ChangeEvents的来源发送到ChangeListeners将是这个JSpinner 。还要注意，替换模型不会影响直接添加到JSpinner的监听器。应用程序可以直接向模型添加监听器。在这种情况下，事件的来源将是SpinnerModel 。
    
    参数
    
    listener - 要添加的 ChangeListener
    
    另请参见：
    
    removeChangeListener(javax.swing.event.ChangeListener) ， getModel()
  - removeChangeListener
```
public void removeChangeListener(ChangeListener listener)
```
    从此微调器中移除 ChangeListener 。
    
    参数
    
    listener - 要删除的 ChangeListener
    
    另请参见：
    
    fireStateChanged() ， addChangeListener(javax.swing.event.ChangeListener)
  - getChangeListeners
```
public ChangeListener[] getChangeListeners()
```
    返回使用addChangeListener（）添加到此JSpinner的所有 ChangeListener的数组。
    
    结果
    
    添加了所有 ChangeListener如果没有添加任何监听器，则为空数组
    
    从以下版本开始：
    
    1.4
  - fireStateChanged
```
protected void fireStateChanged()
```
    发送一个ChangeEvent ，其来源是这JSpinner ，每个ChangeListener 。当一个ChangeListener已添加到微调器时，每次从模型接收到一个ChangeEvent时，将调用此方法方法。
    
    另请参见：
    
    addChangeListener(javax.swing.event.ChangeListener) ， removeChangeListener(javax.swing.event.ChangeListener) ， EventListenerList
  - getPreviousValue
```
public Object getPreviousValue()
```
    返回在getValue()返回的对象之前的序列中的对象。如果序列的结尾已经到达，则返回null 。调用此方法不影响value 。
    这个方法只是委托给model 。相当于：
```
  getModel().getPreviousValue() 
```
    结果
    
    以前的合法价值或 null如果不存在
    
    另请参见：
    
    getValue() ， getNextValue() ， SpinnerModel.getPreviousValue()
  - setEditor
```
public void setEditor(JComponent editor)
```
    更改显示JComponent的当前值的SpinnerModel 。这种方法有责任将旧的编辑器与模型断开连接，并连接新的编辑器。这可能意味着从模型或微调器本身中删除旧编辑器ChangeListener ，并为新编辑器添加一个。
    
    参数
    
    editor - 新编辑
    
    异常
    
    IllegalArgumentException - 如果编辑器是 null
    
    另请参见：
    
    getEditor() ， createEditor(javax.swing.SpinnerModel) ， getModel()
  - getEditor
```
public JComponent getEditor()
```
    返回显示的组件，并可能更改模型的值。
    
    结果
    
    该组件显示并潜在地更改模型的值
    
    另请参见：
    
    setEditor(javax.swing.JComponent) ， createEditor(javax.swing.SpinnerModel)
  - commitEdit
```
public void commitEdit()
                throws ParseException
```
    将当前编辑的值提交给SpinnerModel 。
    如果编辑器是一个DefaultEditor一个实例，调用如果转发给编辑器，否则这样做什么都不做。
    
    异常
    
    ParseException - 如果当前编辑的值无法提交。
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获得 AccessibleContext为 JSpinner
    
    Specified by:
    
    getAccessibleContext在接口 Accessible
    
    重写：
    
    getAccessibleContext在 Component
    
    结果
    
    AccessibleContext为 JSpinner
    
    从以下版本开始：
    
    1.5

Class JSpinner

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

构造方法详细信息

JSpinner

JSpinner

方法详细信息

getUI

setUI

getUIClassID

updateUI

createEditor

setModel

getModel

getValue

setValue

getNextValue

addChangeListener

removeChangeListener

getChangeListeners

fireStateChanged

getPreviousValue

setEditor

getEditor

commitEdit

getAccessibleContext