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

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

Возвращает:

значение свойства минимального значения

См. также:

setMinimum

void setMinimum(int newMinimum)

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

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

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

Параметры:

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

См. также:

getMaximum

int getMaximum()

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

Возвращает:

значение свойства максимального значения.

См. также:

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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/BoundedRangeModel.html