Класс JSpinner

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

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

Спиннер имеет единственный дочерний компонент, который отвечает за отображение и, возможно, изменение текущего элемента или значения модели, который называется editor. Редактор создаётся конструктором JSpinner и может быть изменён свойством editor. Редактор спиннера синхронизируется с моделью, прослушивая 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 Tutorial.

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

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

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

JSpinner

public JSpinner(SpinnerModel model)

Создаёт спиннер для заданной модели. Спиннер имеет кнопки "Предыдущее" / "Следующее" и редактор, подходящий для модели.

Исключения:

NullPointerException - если модель null

JSpinner

public JSpinner()

Создаёт спиннер со значением по умолчанию 0 и без минимальных или максимальных ограничений.

Методы

getUI

public SpinnerUI getUI()

Возвращает объект визуального представления (L&F), который отрисовывает этот компонент.

Возвращает:

объект визуального представления (L&F), который отрисовывает этот компонент

setUI

public void setUI(SpinnerUI ui)

Устанавливает объект визуального представления (L&F), который отрисовывает этот компонент.

Параметры:

ui - объект визуального представления (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)

Параметры:

model - значение getModel

Возвращает:

компонент, отображающий текущее значение последовательности

См. также:

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

setModel

public void setModel(SpinnerModel model)

Изменяет модель, представляющую значение этого спиннера. Если свойство editor не было явно установлено, оно (неявно) устанавливается после того, как было вызвано событие изменения модели. Свойство editor устанавливается в значение, возвращаемое методом getEditor(), как в:

setEditor(createEditor(model));

Параметры:

model - новая модель

Исключения:

IllegalArgumentException - если модель null

См. также:

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

getModel

public SpinnerModel getModel()

Возвращает модель, определяющую последовательность значений этого спиннера.

Возвращает:

значение свойства модели

См. также:

setModel(javax.swing.SpinnerModel)

getValue

public Object getValue()

getModel().getValue()

См. также:

setValue(java.lang.Object), SpinnerModel.getValue()

setValue

public void setValue(Object value)

getModel().setValue(value)

Исключения:

IllegalArgumentException - если value недопустимо

См. также:

getValue(), SpinnerModel.setValue(java.lang.Object)

getNextValue

public Object getNextValue()

getModel().getNextValue()

Возвращает:

следующее допустимое значение или значение по умолчанию, если оно не существует

См. также:

getValue(), getPreviousValue(), SpinnerModel.getNextValue()

addChangeListener

public void addChangeListener(ChangeListener listener)

Добавляет слушателя в список, который уведомляется каждый раз, когда происходит изменение модели. Источником события изменения, переданного слушателю, будет этот спиннер. Обратите внимание, что замена модели не повлияет на слушателей, добавленных непосредственно в JSpinner. Приложения могут добавлять слушателей непосредственно к модели. В этом случае источником события будет модель.

Параметры:

listener - слушатель для добавления

См. также:

removeChangeListener(javax.swing.event.ChangeListener), getModel()

removeChangeListener

public void removeChangeListener(ChangeListener listener)

Удаляет слушателя из спиннера.

Параметры:

listener - слушатель для удаления

См. также:

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

getChangeListeners

public ChangeListener[] getChangeListeners()

Возвращает массив всех слушателей, добавленных в этот JSpinner с помощью addChangeListener().

Возвращает:

массив всех добавленных слушателей или пустой массив, если слушатели не добавлены

С тех пор как:

1.4

fireStateChanged

protected void fireStateChanged()

Отправляет событие изменения модели всем слушателям, источником которого является этот спиннер. Когда слушатель добавлен к спиннеру, этот метод вызывается каждый раз, когда поступает событие изменения от модели.

См. также:

addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener), EventListenerList

getPreviousValue

public Object getPreviousValue()

getModel().getPreviousValue()

Возвращает:

предыдущее допустимое значение или значение по умолчанию, если оно не существует

См. также:

getValue(), getNextValue(), SpinnerModel.getPreviousValue()

setEditor

public void setEditor(JComponent editor)

Изменяет редактор, отображающий текущее значение модели. Ответственность этого метода - отсоединить старый редактор от модели и подключить новый редактор. Это может означать удаление старого редактора из модели или спиннера и добавление нового для нового редактора.

Параметры:

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

Исключения:

ParseException - если текущее редактируемое значение не может быть сохранено.

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext для JSpinner

Определено в:

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

Переопределяет:

getAccessibleContext в классе Component

Возвращает:

AccessibleContext для JSpinner

С:

1.5