javax.swing

Класс JSpinner

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

javax.swing. JComponent

javax.swing. JSpinner

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

public class JSpinner
extends JComponent
implements Accessible

Однострочное поле ввода, которое позволяет пользователю выбирать число или объектное значение от упорядоченной последовательности. Прядильщики обычно обеспечивают пару крошечных кнопок стрелки для того, чтобы ступить через элементы последовательности. Клавиатура/клавиши со стрелкой вниз также цикл через элементы. Пользователя можно также разрешить типу a (юридическое) значение непосредственно в прядильщика. Хотя поля комбинированного списка обеспечивают подобную функциональность, прядильщики иногда предпочитаются, потому что они не требуют выпадающего списка, который может затенить важные данные.

A JSpinner's значение последовательности определяется SpinnerModel. model может быть определен как параметр конструктора и изменен с model свойство. SpinnerModel классы для некоторых общих типов обеспечиваются: SpinnerListModel, SpinnerNumberModel, и SpinnerDateModel.

A JSpinner имеет единственный дочерний компонент, который это ответственно за то, что вывело на экран и потенциально изменило текущий элемент или значение модели, которую вызывают editor. Редактор создается JSpinner's конструктор и может быть изменен с editor свойство. JSpinner's редактор остается в синхронизации с моделью, прислушиваясь ChangeEvents. Если пользователь изменил значение, выведенное на экран editor это возможно для model's значение, чтобы отличаться от того из editor. Удостовериться model имеет то же самое значение как использование редактора commitEdit метод, eg:

   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();
 

Для получения информации и примеры использования прядильщика видят, Как Использовать Прядильщиков, раздел в Учебном руководстве по Java.

Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.

Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

С тех пор:

1.4

См. Также:

SpinnerModel, AbstractSpinnerModel, SpinnerListModel, SpinnerNumberModel, SpinnerDateModel, JFormattedTextField

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	JSpinner. AccessibleJSpinner AccessibleJSpinner доступность реализаций поддерживает для JSpinner class.
static class	JSpinner. DateEditor Редактор для a JSpinner чья модель является a SpinnerDateModel.
static class	JSpinner. DefaultEditor Простой основной class для более специализированных редакторов, который выводит на экран представление только для чтения текущей стоимости модели с a JFormattedTextField.
static class	JSpinner. ListEditor Редактор для a JSpinner чья модель является a SpinnerListModel.
static class	JSpinner. NumberEditor Редактор для a JSpinner чья модель является a SpinnerNumberModel.

Вложенные классы/интерфейсы, наследованные от class javax.swing. JComponent

JComponent. AccessibleJComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля, наследованные от class javax.swing. JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, наследованные от class java.awt. Компонент

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструктора

Конструкторы

Конструктор и Описание
JSpinner() Создает прядильщика с Integer SpinnerNumberModel с начальным значением 0 и никакими минимальными или максимальными пределами.
JSpinner(SpinnerModel model) Создает прядильщика для данной модели.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addChangeListener(ChangeListener listener) Добавляет слушатель списка, который уведомляется каждый раз, когда изменение к модели происходит.
void	commitEdit() Фиксирует в настоящий момент отредактированное значение SpinnerModel.
protected JComponent	createEditor(SpinnerModel model) Этот метод вызывают конструкторы, чтобы создать JComponent это выводит на экран текущую стоимость последовательности.
protected void	fireStateChanged() Отправляет a ChangeEvent, чей источник - это JSpinner, каждому ChangeListener.
AccessibleContext	getAccessibleContext() Добирается AccessibleContext для JSpinner
ChangeListener[]	getChangeListeners() Возвращает массив весь ChangeListeners добавленный к этому JSpinner с addChangeListener ().
JComponent	getEditor() Возвращает компонент, который выводит на экран и потенциально изменяет значение модели.
SpinnerModel	getModel() Возвраты SpinnerModel это определяет эту последовательность прядильщиков значений.
Объект	getNextValue() Возвращает объект в последовательности, которая прибывает после объекта, возвращенного getValue().
Объект	getPreviousValue() Возвращает объект в последовательности, которая прибывает перед объектом, возвращенным getValue().
SpinnerUI	getUI() Возвращает стиль (L&F) объект, который представляет этот компонент.
Строка	getUIClassID() Возвращает суффикс, используемый, чтобы создать имя стили (L&F) class, используемый, чтобы представить этот компонент.
Объект	getValue() Возвращает текущую стоимость модели, обычно это значение выводится на экран editor.
void	removeChangeListener(ChangeListener listener) Удаляет a 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 со значением от текущего стили.

Методы, наследованные от 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

Методы, наследованные от class java.awt. Контейнер

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

Методы, наследованные от class java.awt. Компонент

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

Методы, наследованные от class java.lang. Объект

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) class, используемый, чтобы представить этот компонент.

Переопределения:

getUIClassID в class JComponent

Возвраты:

строка "SpinnerUI"

См. Также:

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

updateUI

public void updateUI()

Сбрасывает свойство UI со значением от текущего стили.

Переопределения:

updateUI в class 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's значение, чтобы отличаться от того из editor, обратитесь к уровню class 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)

Удаляет a ChangeListener от этого прядильщика.

Параметры:

listener - ChangeListener удалить

См. Также:

fireStateChanged(), addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()

Возвращает массив весь ChangeListeners добавленный к этому JSpinner с addChangeListener ().

Возвраты:

весь из ChangeListeners добавленный или пустой массив, если никакие слушатели не были добавлены

С тех пор:

1.4

fireStateChanged

protected void fireStateChanged()

Отправляет a ChangeEvent, чей источник - это JSpinner, каждому ChangeListener. Когда a ChangeListener был добавлен к прядильщику, этот метод метода вызывают каждый раз a 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

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleContext для JSpinner

С тех пор:

1.5