javax.swing

Class JSpinner

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