Класс DefaultBoundedRangeModel

java.lang.Object

javax.swing.DefaultBoundedRangeModel

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

public class DefaultBoundedRangeModel extends Object implements BoundedRangeModel, Serializable

Общее реализация интерфейса BoundedRangeModel.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. 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, убедившись, что n и другие три свойства соответствуют ограничениям модели:
`void`	`setMinimum(int n)`	Устанавливает минимум в 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`.

Методы, унаследованные от класса java.lang.Object

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

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

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

Параметры:: 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, убедившись, что n и остальные три свойства подчиняются ограничениям модели:

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

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

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

Параметры:

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

См. также:

setMaximum

public void setMaximum(int n)

Устанавливает максимум в 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 - boolean, true, если выполняется ряд изменений

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

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

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

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

Параметры:

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

См. также:

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener.

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

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

Параметры:

l - ChangeListener для удаления

См. также:

getChangeListeners

public ChangeListener[] getChangeListeners()

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

Возвращает:

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

С момента:

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 для данной модели. Слушатели регистрируются с помощью метода addFooListener.

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

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

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

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

T - тип класса слушателя, который запрашивается

Параметры:

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/DefaultBoundedRangeModel.html