Класс DefaultBoundedRangeModel

java.lang.Object

javax.swing.DefaultBoundedRangeModel

Все реализованные интерфейсы:: Serializable, BoundedRangeModel

public class DefaultBoundedRangeModel extends Object implements BoundedRangeModel, Serializable

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

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

Начиная с:

1.2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected ChangeEvent`	`changeEvent`	Для каждого экземпляра модели достаточно одного `ChangeEvent`, поскольку единственное (доступное только для чтения) состояние события — это свойство источника.
`protected EventListenerList`	`listenerList`	Слушатели, ожидающие изменений модели.

Краткое описание конструкторов

Конструктор	Описание
`DefaultBoundedRangeModel()`	Инициализирует все свойства значениями по умолчанию.
`DefaultBoundedRangeModel(int value, int extent, int min, int max)`	Инициализирует значение, размер диапазона, минимум и максимум.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addChangeListener(ChangeListener l)`	Добавляет `ChangeListener`.
`protected void`	`fireStateChanged()`	Вызывает метод `stateChanged` каждого `ChangeListener`.
`ChangeListener[]`	`getChangeListeners()`	Возвращает массив всех слушателей изменений, зарегистрированных в этой `DefaultBoundedRangeModel`.
`int`	`getExtent()`	Возвращает размер диапазона модели.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в этой модели как `FooListener`.
`int`	`getMaximum()`	Возвращает максимальное значение модели.
`int`	`getMinimum()`	Возвращает минимальное значение модели.
`int`	`getValue()`	Возвращает текущее значение модели.
`boolean`	`getValueIsAdjusting()`	Возвращает true, если значение изменяется в результате действий пользователя.
`void`	`removeChangeListener(ChangeListener l)`	Удаляет `ChangeListener`.
`void`	`setExtent(int n)`	Устанавливает размер диапазона равным n, предварительно проверив, что n больше или равно нулю и соответствует ограничениям модели:
`void`	`setMaximum(int n)`	Устанавливает максимальное значение равным n, предварительно проверив, что остальные три свойства соответствуют ограничениям модели:
`void`	`setMinimum(int n)`	Устанавливает минимальное значение равным n, предварительно проверив, что остальные три свойства соответствуют ограничениям модели:
`void`	`setRangeProperties(int newValue, int newExtent, int newMin, int newMax, boolean adjusting)`	Устанавливает все свойства `BoundedRangeModel`, предварительно приводя аргументы в соответствие с обычными ограничениями:
`void`	`setValue(int n)`	Устанавливает текущее значение модели.
`void`	`setValueIsAdjusting(boolean b)`	Устанавливает свойство `valueIsAdjusting`.
`String`	`toString()`	Возвращает строку, отображающую все свойства `BoundedRangeModel`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

changeEvent

protected transient ChangeEvent changeEvent

Для каждого экземпляра модели достаточно одного ChangeEvent, поскольку единственное (доступное только для чтения) состояние события — это свойство источника. Источником создаваемых здесь событий всегда является «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)

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

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

Параметры:: value — целое число, задающее текущее значение; extent — длина внутреннего диапазона, начинающегося со значения модели; min — целое число, задающее минимальное значение; max — целое число, задающее максимальное значение

Подробное описание методов

getValue

public int getValue()

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

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

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

Возвращает:

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

См. также:

getExtent

public int getExtent()

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

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

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

Возвращает:

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

См. также:

getMinimum

public int getMinimum()

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

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

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

Возвращает:

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

См. также:

getMaximum

public int getMaximum()

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

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

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

Возвращает:

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

См. также:

setValue

public void setValue(int n)

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

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

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

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

Параметры:

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

См. также:

setExtent

public void setExtent(int n)

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

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

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

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

Параметры:

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

См. также:

setMinimum

public void setMinimum(int n)

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

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

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

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

Параметры:

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

См. также:

setMaximum

public void setMaximum(int n)

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

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

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

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

Параметры:

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

См. также:

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

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

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

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

Параметры:

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

См. также:

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

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

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

Возвращает:

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

См. также:

setRangeProperties

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

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

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

Создаётся не более одного ChangeEvent.

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

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

Параметры:

newValue — целое число, задающее текущее значение

newExtent — целое число, задающее величину, на которую значение может «перепрыгнуть»

newMin — целое число, задающее минимальное значение

newMax — целое число, задающее максимальное значение

adjusting — логическое значение: true, если выполняется последовательность изменений

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

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

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

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

Параметры:

l — ChangeListener, который нужно добавить

См. также:

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener.

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

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

Параметры:

l — ChangeListener, который нужно удалить

См. также:

getChangeListeners

public ChangeListener[] getChangeListeners()

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

Возвращает:

всех ChangeListener этой модели или пустой массив, если в данный момент не зарегистрировано ни одного слушателя изменений

Начиная с:

1.4

См. также:

fireStateChanged

protected void fireStateChanged()

Вызывает метод stateChanged каждого ChangeListener.

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта

getListeners

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

Возвращает массив всех объектов, зарегистрированных в этой модели как FooListener. Регистрация FooListener выполняется с помощью метода addFooListener.

В качестве аргумента listenerType можно указать литерал класса, например FooListener.class. Например, можно запросить у экземпляра DefaultBoundedRangeModel m список слушателей изменений следующим образом:

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

Если таких слушателей нет, этот метод возвращает пустой массив.

Параметры типа:

T — тип запрашиваемого класса EventListener

Параметры:

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

Возвращает:

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

Выбрасывает:

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

Начиная с:

1.3

См. также:

© 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/DefaultBoundedRangeModel.html