javax.swing

Интерфейс BoundedRangeModel

Все Известные Классы с реализацией:

DefaultBoundedRangeModel

public interface BoundedRangeModel

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

 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 определяются как свойства Beans Java однако Swing, ChangeEvents используются, чтобы уведомить клиенты изменений, а не PropertyChangeEvents. Это было сделано, чтобы сохранить издержки контроля BoundedRangeModel низко. В изменения часто являются уровни MouseDragged.

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

См. Также:

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()

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

Возвраты:

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

См. Также:

setMinimum(int)

setMinimum

void setMinimum(int newMinimum)

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

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

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

Параметры:

newMinimum - новый минимум модели

См. Также:

getMinimum(), addChangeListener(javax.swing.event.ChangeListener)

getMaximum

int getMaximum()

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

Возвраты:

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

См. Также:

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)

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

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

Параметры:

b - истина, если предстоящие изменения к свойству значения являются частью ряда

getValueIsAdjusting

boolean getValueIsAdjusting()

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

Возвраты:

valueIsAdjustingProperty.

См. Также:

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 - булево, истинное, если серия изменений происходит

См. Также:

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)