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

См. также:

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 принудительно устанавливается больше или равно нулю и меньше или равно максимальному значению - значению.

При использовании модели 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, 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/BoundedRangeModel.html