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

См. также:

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

Модификатор и тип	Метод	Описание
`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

void setMinimum(int newMinimum)

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

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

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

Параметры:

newMinimum - новое минимальное значение модели

См. также:

getMaximum

int getMaximum()

Возвращает максимальное значение модели. Обратите внимание, что верхняя граница значения модели равна (maximum - extent).

Возвращает:

значение свойства maximum.

См. также:

setMaximum

void setMaximum(int newMaximum)

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

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

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

Параметры:

newMaximum - новое максимальное значение модели

См. также:

getValue

int getValue()

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

Возвращает:

значение модели

См. также:

setValue

void setValue(int newValue)

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

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

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

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

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

Параметры:

newValue - новое значение модели

См. также:

setValueIsAdjusting

void setValueIsAdjusting(boolean b)

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

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

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

getValueIsAdjusting

boolean getValueIsAdjusting()

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

Возвращает:

свойство valueIsAdjusting.

См. также:

getExtent

int getExtent()

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

Возвращает:

значение свойства области модели

См. также:

setExtent

void setExtent(int newExtent)

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

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

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

Параметры:

newExtent - новая область модели

См. также:

setRangeProperties

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

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

Параметры:

value - целое число, задающее текущее значение

extent - целое число, задающее величину, на которую значение может «перепрыгнуть»

min - целое число, задающее минимальное значение

max - целое число, задающее максимальное значение

adjusting - булево значение, true, если выполняется серия изменений

См. также:

addChangeListener

void addChangeListener(ChangeListener x)

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

Параметры:

x - добавляемый ChangeListener

См. также:

removeChangeListener

void removeChangeListener(ChangeListener x)

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

Параметры:

x - удаляемый ChangeListener

См. также:

© 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/BoundedRangeModel.html