Класс 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 - булево значение, 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()

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

См. также:

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

См. также:

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