Интерфейс BoundedRangeModel

Все известные реализующие классы:: DefaultBoundedRangeModel

public interface BoundedRangeModel

Определяет модель данных, используемую компонентами, такими как Slider и ProgressBar. Определяет четыре взаимосвязанные целочисленные свойства: минимум, максимум, протяжённость и значение. Эти четыре целых числа определяют два вложенных диапазона так:

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

Внешний диапазон — minimum,maximum, а внутренний диапазон — value,value+extent. Внутренний диапазон должен находиться внутри внешнего, т. е. value должно быть меньше или равно maximum, а value+extent должно быть больше или равно minimum, и maximum должно быть больше или равно minimum. Есть несколько особенностей этой модели, которые могут показаться немного неожиданными. Эти особенности существуют для удобства клиентов Swing BoundedRangeModel, таких как Slider и ScrollBar.

Методы установки минимума и максимума «исправляют» другие три свойства, чтобы соответствовать новому значению аргумента. Например, установка минимального значения модели может изменить свойства максимума, значения и протяжённости (в указанном порядке), чтобы сохранить указанные выше ограничения.
Методы установки значения и протяжённости «исправляют» свой аргумент, чтобы он соответствовал пределам, определённым другими тремя свойствами. Например, если value == maximum, setExtent(10) изменит протяжённость (обратно) на ноль.
Четыре значения BoundedRangeModel определены как свойства Java Beans, однако для уведомления клиентов о изменениях используются Swing ChangeEvents, а не PropertyChangeEvents. Это было сделано, чтобы снизить нагрузку на отслеживание BoundedRangeModel. Изменения часто сообщаются со скоростью MouseDragged.

Пример задания пользовательских моделей ограниченного диапазона, используемых ползунками, см. в Архитектуре разделимых моделей в Обзоре архитектуры Swing.

См. также:: DefaultBoundedRangeModel

Методы

Модификатор и тип	Метод и описание
`void`	`addChangeListener(ChangeListener x)` Добавляет ChangeListener в список слушателей модели.
`int`	`getExtent()` Возвращает протяжённость модели, длину внутреннего диапазона, начинающегося со значения модели.
`int`	`getMaximum()` Возвращает максимальное значение модели.
`int`	`getMinimum()` Возвращает минимальное допустимое значение.
`int`	`getValue()` Возвращает текущее значение модели.
`boolean`	`getValueIsAdjusting()` Возвращает true, если текущие изменения свойства значения являются частью серии изменений.
`void`	`removeChangeListener(ChangeListener x)` Удаляет ChangeListener из списка слушателей модели.
`void`	`setExtent(int newExtent)` Устанавливает протяжённость модели.
`void`	`setMaximum(int newMaximum)` Устанавливает максимальное значение модели на newMaximum.
`void`	`setMinimum(int newMinimum)` Устанавливает минимальное значение модели на newMinimum.
`void`	`setRangeProperties(int value, int extent, int min, int max, boolean adjusting)` Этот метод устанавливает все данные модели с помощью одного вызова метода.
`void`	`setValue(int newValue)` Устанавливает текущее значение модели на `newValue`, если `newValue` удовлетворяет ограничениям модели.
`void`	`setValueIsAdjusting(boolean b)` Этот атрибут указывает, что все последующие изменения значения модели должны рассматриваться как одно событие.

Методы

getMinimum

int getMinimum()

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

Возвращает:: значение свойства minimum
См. также:: setMinimum(int)

setMinimum

void setMinimum(int newMinimum)

Устанавливает минимальное значение модели в newMinimum. Другие три свойства также могут быть изменены, чтобы гарантировать, что:

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

Уведомляет всех слушателей об изменениях модели.

Параметры:: newMinimum - новое минимальное значение модели
См. также:: getMinimum(), addChangeListener(javax.swing.event.ChangeListener)

getMaximum

int getMaximum()

Возвращает максимальное значение модели. Обратите внимание, что верхний предел значения модели равен (максимум - величина).

Возвращает:: значение свойства maximum.
См. также:: setMaximum(int), setExtent(int)

setMaximum

void setMaximum(int newMaximum)

Устанавливает максимальное значение модели в newMaximum. Другие три свойства также могут быть изменены, чтобы гарантировать, что

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

Уведомляет всех слушателей об изменениях модели.

Параметры:: newMaximum - новое максимальное значение модели
См. также:: getMaximum(), addChangeListener(javax.swing.event.ChangeListener)

getValue

int getValue()

Возвращает текущее значение модели. Обратите внимание, что верхний предел значения модели равен maximum - extent, а нижний предел равен minimum.

Возвращает:: значение модели
См. также:: setValue(int)

setValue

void setValue(int newValue)

Устанавливает текущее значение модели в newValue если newValue удовлетворяет ограничениям модели. Эти ограничения:

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

В противном случае, если newValue меньше minimum, оно устанавливается в minimum, если оно больше maximum, то оно устанавливается в maximum, а если оно больше value+extent, то оно устанавливается в value+extent.

Если модель BoundedRange используется со скроллбаром, значение задает начало рычажка скроллбара (также известного как "кнопка" или "лифт"). Значение обычно представляет начало видимой части объекта, который прокручивается.

Уведомляет всех слушателей об изменениях модели.

Параметры:: newValue - новое значение модели
См. также:: getValue()

setValueIsAdjusting

void setValueIsAdjusting(boolean b)

Это атрибут указывает, что все предстоящие изменения значения модели должны рассматриваться как одно событие. Этот атрибут будет установлен в true в начале серии изменений значения и будет установлен в false, когда изменение значения завершится. Обычно это позволяет слушателю выполнять действия только тогда, когда окончательное изменение значения подтверждено, вместо того, чтобы выполнять обновления для всех промежуточных значений.

Ползунки и скроллбары используют это свойство, когда происходит перетаскивание.

Параметры:: b - true, если предстоящие изменения свойства значения являются частью серии

getValueIsAdjusting

boolean getValueIsAdjusting()

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

Возвращает:: свойство valueIsAdjusting.
См. также:: setValueIsAdjusting(boolean)

getExtent

int getExtent()

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

Возвращает:: значение свойства величины модели
См. также:: setExtent(int), setValue(int)

setExtent

void setExtent(int newExtent)

Устанавливает величину модели. newExtent принудительно устанавливается больше или равно нулю и меньше или равно maximum - value.

Если модель BoundedRange используется со скроллбаром, величина определяет длину рычажка скроллбара (также известного как "кнопка" или "лифт"). Величина обычно представляет собой количество видимой части объекта, который прокручивается. При использовании с ползунком величина определяет, на сколько значение может "перепрыгнуть", например, когда пользователь нажимает клавиши PgUp или PgDn.

Уведомляет всех слушателей об изменениях модели.

Параметры:: newExtent - новая величина модели
См. также:: getExtent(), setValue(int)

setRangeProperties

void setRangeProperties(int value,
                        int extent,
                        int min,
                        int max,
                        boolean adjusting)

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

Параметры:: value - целое число, представляющее текущее значение; extent - целое число, представляющее величину "перескока" значения; min - целое число, представляющее минимальное значение; max - целое число, представляющее максимальное значение; adjusting - булево значение, true, если происходит серия изменений
См. также:: setValue(int), setExtent(int), setMinimum(int), setMaximum(int), setValueIsAdjusting(boolean)

addChangeListener

void addChangeListener(ChangeListener x)

Добавляет ChangeListener в список слушателей модели.

Параметры:: x - добавляемый ChangeListener
См. также:: removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

void removeChangeListener(ChangeListener x)

Удаляет ChangeListener из списка слушателей модели.

Параметры:: x - удаляемый ChangeListener
См. также:: addChangeListener(javax.swing.event.ChangeListener)

© 1993, 2020, 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.