Класс JSpinner

@JavaBean(defaultProperty="UI",
          description="A single line input field that lets the user select a number or an object value from an ordered set.")
public class JSpinner
extends JComponent
implements Accessible

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

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

У JSpinner есть один дочерний компонент, который отвечает за отображение и, потенциально, изменение текущего элемента или значения модели, который называется 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();

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

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

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