Интерфейс SpinnerModel
- Все известные реализующие классы:
- AbstractSpinnerModel, SpinnerDateModel, SpinnerListModel, SpinnerNumberModel
public interface SpinnerModel
Модель для потенциально неограниченной последовательности значений объектов. Эта модель похожа на ListModel, однако существуют некоторые важные различия:
- Количество элементов последовательности необязательно ограничено.
- Модель не поддерживает индексированный произвольный доступ к элементам последовательности. Одновременно доступны только три значения последовательности: текущее, следующее и предыдущее.
- Текущий элемент последовательности может быть установлен.
Модель SpinnerModel имеет три свойства, только первое из которых является читаемо-записываемым.
-
value - Текущий элемент последовательности.
-
nextValue - Следующий элемент или null, если
valueявляется последним элементом последовательности. -
previousValue - Предыдущий элемент или null, если
valueявляется первым элементом последовательности.
value, уведомляются ChangeListeners. SpinnerModel может выбрать уведомление ChangeListeners и в других обстоятельствах.- С момента:
- 1.4
- См. также:
-
JSpinner,AbstractSpinnerModel,SpinnerListModel,SpinnerNumberModel,SpinnerDateModel
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
addChangeListener(ChangeListener l) Добавляет слушателя |
Object |
getNextValue() Возвращает объект в последовательности, который следует за объектом, возвращенным |
Object |
getPreviousValue() Возвращает объект в последовательности, который предшествует объекту, возвращенному |
Object |
getValue() Текущий элемент последовательности. |
void |
removeChangeListener(ChangeListener l) Удаляет слушателя |
void |
setValue(Object value) Изменяет текущее значение модели, обычно это значение отображается частью |
Методы
getValue
Object getValue()
Текущий элемент последовательности. Этот элемент обычно отображается частью editor компонента JSpinner.
- Возвращает:
- текущее значение спиннера.
- См. также:
setValue(java.lang.Object)
setValue
void setValue(Object value)
Изменяет текущее значение модели, обычно это значение отображается частью editor компонента JSpinner. Если реализация SpinnerModel не поддерживает указанное значение, выбрасывается IllegalArgumentException исключение. Например, SpinnerModel для чисел может поддерживать только значения, являющиеся целыми кратными десяти. В этом случае model.setValue(new Number(11)) выбросит исключение.
- Исключения:
-
IllegalArgumentException- еслиvalueне разрешено - См. также:
getValue()
getNextValue
Object getNextValue()
Возвращает объект в последовательности, который следует за объектом, возвращенным getValue(). Если достигнут конец последовательности, возвращается null. Вызов этого метода не влияет на value.
- Возвращает:
- следующее допустимое значение или null, если оно не существует
- См. также:
-
getValue(),getPreviousValue()
getPreviousValue
Object getPreviousValue()
Возвращает объект в последовательности, который предшествует объекту, возвращенному getValue(). Если достигнут конец последовательности, возвращается null. Вызов этого метода не влияет на value.
- Возвращает:
- предыдущее допустимое значение или null, если оно не существует
- См. также:
-
getValue(),getNextValue()
addChangeListener
void addChangeListener(ChangeListener l)
Добавляет ChangeListener в список слушателей модели. ChangeListeners должен быть уведомлен, когда изменяются свойства value модели.
- Параметры:
-
l- слушатель ChangeListener для добавления - См. также:
removeChangeListener(javax.swing.event.ChangeListener)
removeChangeListener
void removeChangeListener(ChangeListener l)
Удаляет ChangeListener из списка слушателей модели.
- Параметры:
-
l- слушатель ChangeListener для удаления - См. также:
addChangeListener(javax.swing.event.ChangeListener)
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.