Интерфейс 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.

С:: 1.2
См. также:: 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 - extent).

Возвращает:: значение свойства 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()

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

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

setExtent

void setExtent(int newExtent)

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

Когда модель BoundedRange используется с ползунком, величина определяет длину ползунка (также известного как «джойстик» или «подъемник»). Величина обычно представляет собой часть объекта, который прокручивается, которая видна. При использовании с ползунком величина определяет, насколько значение может «перепрыгнуть», например, при нажатии клавиш Page Up или Page Down.

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

Параметры:: 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/BoundedRangeModel.html