Класс 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)`	Инициализирует значения value, extent, minimum и maximum.

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

Модификатор и тип	Метод	Описание
`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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело и предназначено для удаления: этот элемент API может быть удален в будущем выпуске. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения определенного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения определенного периода реального времени.

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

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)

Инициализирует value, extent, minimum и maximum. Свойство 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.