Класс 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

См. также:

BoundedRangeModel

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

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

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

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

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

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

Методы, унаследованные от класса 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 - новое значение модели

См. также:

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 - новый минимум модели

См. также:

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

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

См. также:

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

END_OF_DOCUMENT_MARKER

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)

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

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

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

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

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

С тех пор:

1.3

См. также:

getChangeListeners()

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/DefaultBoundedRangeModel.html