Класс DefaultBoundedRangeModel

Общее реализация BoundedRangeModel.

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

Поля

changeEvent

protected transient ChangeEvent changeEvent

Требуется только один ChangeEvent на экземпляр модели, так как единственное (только для чтения) состояние события — это свойство source. Источник событий, генерируемых здесь, всегда «this».

listenerList

protected EventListenerList listenerList

Прослушиватели, ожидающие изменений модели.

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

DefaultBoundedRangeModel

public DefaultBoundedRangeModel()

Инициализирует все свойства значениями по умолчанию. Эти значения:

• value = 0
• extent = 0
• minimum = 0
• maximum = 100
• adjusting = false

DefaultBoundedRangeModel

public DefaultBoundedRangeModel(int value,
                                int extent,
                                int min,
                                int max)

Инициализирует значение, диапазон, минимум и максимум. Настройка равна false. Бросает IllegalArgumentException, если не выполняются следующие ограничения:

min <= value <= value+extent <= max

Методы

getValue

public int getValue()

Возвращает текущее значение модели.

Указано в:

getValue в интерфейсе BoundedRangeModel

Возвращает:

текущее значение модели

См. также:

setValue(int), BoundedRangeModel.getValue()

getExtent

public int getExtent()

Возвращает диапазон модели.

Указано в:

getExtent в интерфейсе BoundedRangeModel

Возвращает:

диапазон модели

См. также:

setExtent(int), BoundedRangeModel.getExtent()

getMinimum

public int getMinimum()

Возвращает минимальное значение модели.

Указано в:

getMinimum в интерфейсе BoundedRangeModel

Возвращает:

минимальное значение модели

См. также:

setMinimum(int), BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()

Возвращает максимальное значение модели.

Указано в:

getMaximum в интерфейсе BoundedRangeModel

Возвращает:

максимальное значение модели

См. также:

setMaximum(int), BoundedRangeModel.getMaximum()

setValue

public void setValue(int n)

Устанавливает текущее значение модели. Для ползунка это определяет, где появляется ручка. Обеспечивает, что новое значение n находится в пределах ограничений модели:

minimum <= value <= value+extent <= maximum

Указано в:

setValue в интерфейсе BoundedRangeModel

Параметры:

n - новое значение модели

См. также:

BoundedRangeModel.setValue(int)

setExtent

public void setExtent(int n)

Устанавливает диапазон в n после проверки, что n больше или равно нулю и находится в пределах ограничений модели:

minimum <= value <= value+extent <= maximum

Указано в:

setExtent в интерфейсе BoundedRangeModel

Параметры:

n - новый диапазон модели

См. также:

BoundedRangeModel.setExtent(int)

setMinimum

public void setMinimum(int n)

Устанавливает минимум в n после проверки, что n и остальные три свойства подчиняются ограничениям модели:

minimum <= value <= value+extent <= maximum

Указано в:

setMinimum в интерфейсе BoundedRangeModel

Параметры:

n - новый минимум модели

См. также:

getMinimum(), BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)

Устанавливает максимум в n после проверки, что n и остальные три свойства подчиняются ограничениям модели:

minimum <= value <= value+extent <= maximum

Указано в:

setMaximum в интерфейсе BoundedRangeModel

Параметры:

n - новый максимум модели

См. также:

BoundedRangeModel.setMaximum(int)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

Устанавливает свойство valueIsAdjusting

Указано в:

setValueIsAdjusting в интерфейсе BoundedRangeModel

Параметры:

b - true, если предстоящие изменения свойства value являются частью серии

См. также:

getValueIsAdjusting(), setValue(int), BoundedRangeModel.setValueIsAdjusting(boolean)

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

Указано в:

getValueIsAdjusting в интерфейсе BoundedRangeModel

Возвращает:

значение свойства valueIsAdjusting

См. также:

setValue(int), BoundedRangeModel.getValueIsAdjusting()

setRangeProperties

public void setRangeProperties(int newValue,
                               int newExtent,
                               int newMin,
                               int newMax,
                               boolean adjusting)

minimum <= value <= value+extent <= maximum

Указано в:

setRangeProperties в интерфейсе BoundedRangeModel

Параметры:

newValue - целое число, представляющее текущее значение

newExtent - целое число, определяющее величину «скачка» значения

newMin - целое число, определяющее минимальное значение

newMax - целое число, определяющее максимальное значение

adjusting - логическое значение, true, если серия изменений находится в процессе

См. также:

BoundedRangeModel.setRangeProperties(int, int, int, int, boolean), setValue(int), setExtent(int), setMinimum(int), setMaximum(int), setValueIsAdjusting(boolean)

addChangeListener

public void addChangeListener(ChangeListener l)

Добавляет ChangeListener. Прослушиватели изменений запускаются каждый раз, когда меняется какое-либо свойство модели Bounded Range.

Указано в:

addChangeListener в интерфейсе BoundedRangeModel

Параметры:

l - добавляемый прослушиватель изменений

См. также:

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener.

Указано в:

removeChangeListener в интерфейсе BoundedRangeModel

Параметры:

l - удаляемый ChangeListener

См. также:

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

getChangeListeners

public ChangeListener[] getChangeListeners()

Возвращает массив всех прослушивателей изменений, зарегистрированных в данной DefaultBoundedRangeModel.

Возвращает:

все ChangeListener модели или пустой массив, если прослушивателей изменений нет

С:

1.4

См. также:

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

fireStateChanged

protected void fireStateChanged()

Выполняет метод ChangeListener для каждого stateChanged.

См. также:

setRangeProperties(int, int, int, int, boolean), EventListenerList

toString

public String toString()

Возвращает строку, отображающую все свойства BoundedRangeModel.

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

toString в классе Object

Возвращает:

строковое представление объекта.

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

ChangeListener[] cls = (ChangeListener[])(m.getListeners(ChangeListener.class));

Параметры:

listenerType - тип запрашиваемых прослушивателей; этот параметр должен указывать интерфейс, унаследованный от java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных в качестве FooListener для этой модели, или пустой массив, если такие прослушиватели не были добавлены

Бросает:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С:

1.3

См. также:

getChangeListeners()