Класс Scrollbar

public class Scrollbar
extends Component
implements Adjustable, Accessible

Класс Scrollbar представляет собой полосу прокрутки, знакомый объект пользовательского интерфейса. Полоса прокрутки предоставляет удобный способ, позволяющий пользователю выбирать из диапазона значений. Следующие три вертикальные полосы прокрутки можно использовать в качестве ползунков для выбора красной, зелёной и синей составляющих цвета:

Каждая полоса прокрутки в этом примере может быть создана кодом, подобным следующему:

redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255);
add(redSlider);

В качестве альтернативы, полоса прокрутки может представлять диапазон значений. Например, если полоса прокрутки используется для прокрутки текста, ширина "пузырька" (также называемого "ползунком" или "областью прокрутки") может быть использована для представления количества видимого текста. Вот пример полосы прокрутки, которая представляет диапазон:

Диапазон значений, представленный пузырьком в этом примере, — это видимая часть. Горизонтальная полоса прокрутки в этом примере может быть создана кодом, подобным следующему:

ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300);
add(ranger);

Обратите внимание, что фактическое максимальное значение полосы прокрутки равно maximum минус visible amount. В предыдущем примере, так как maximum равно 300, а visible amount равно 60, фактическое максимальное значение равно 240. Диапазон полосы прокрутки — 0 - 300. Левая сторона пузырька указывает значение полосы прокрутки.

Обычно пользователь изменяет значение полосы прокрутки, выполняя жесты мышью. Например, пользователь может перетаскивать пузырёк полосы прокрутки вверх и вниз или нажимать на области с шагом в единицу или блок. Жесты клавиатуры также могут быть сопоставлены с полосой прокрутки. По соглашению, клавиши Page Up и Page Down эквивалентны нажатию в области с блочным шагом увеличения и уменьшения полосы прокрутки.

Когда пользователь изменяет значение полосы прокрутки, полоса прокрутки получает экземпляр AdjustmentEvent. Полоса прокрутки обрабатывает это событие, передавая его всем зарегистрированным слушателям.

Любой объект, который хочет получать уведомления об изменениях значения полосы прокрутки, должен реализовать AdjustmentListener, интерфейс, определённый в пакете java.awt.event. Слушатели могут добавляться и удаляться динамически путём вызова методов addAdjustmentListener и removeAdjustmentListener.

Класс AdjustmentEvent определяет пять типов событий изменения, перечисленных здесь:

• AdjustmentEvent.TRACK отправляется при перетаскивании пузырька полосы прокрутки.
• AdjustmentEvent.UNIT_INCREMENT отправляется при нажатии на левую стрелку горизонтальной полосы прокрутки или верхнюю стрелку вертикальной полосы прокрутки, или при эквивалентном жесте с клавиатуры.
• AdjustmentEvent.UNIT_DECREMENT отправляется при нажатии на правую стрелку горизонтальной полосы прокрутки или нижнюю стрелку вертикальной полосы прокрутки, или при эквивалентном жесте с клавиатуры.
• AdjustmentEvent.BLOCK_INCREMENT отправляется при нажатии в области полосы прокрутки слева от пузырька на горизонтальной полосе прокрутки или сверху от пузырька на вертикальной полосе прокрутки. По соглашению, клавиша Page Up эквивалентна, если пользователь использует клавиатуру, которая определяет клавишу Page Up.
• AdjustmentEvent.BLOCK_DECREMENT отправляется при нажатии в области полосы прокрутки справа от пузырька на горизонтальной полосе прокрутки или снизу от пузырька на вертикальной полосе прокрутки. По соглашению, клавиша Page Down эквивалентна, если пользователь использует клавиатуру, которая определяет клавишу Page Down.

Система событий JDK 1.0 поддерживается для обратной совместимости, но её использование с более новыми версиями платформы не рекомендуется. Пять типов событий изменения, введённых с JDK 1.1, соответствуют пяти типам событий, связанным с полосами прокрутки в предыдущих версиях платформы. Следующий список содержит тип события изменения и соответствующий ему тип события JDK 1.0, которое он заменяет.

• AdjustmentEvent.TRACK заменяет Event.SCROLL_ABSOLUTE
• AdjustmentEvent.UNIT_INCREMENT заменяет Event.SCROLL_LINE_UP
• AdjustmentEvent.UNIT_DECREMENT заменяет Event.SCROLL_LINE_DOWN
• AdjustmentEvent.BLOCK_INCREMENT заменяет Event.SCROLL_PAGE_UP
• AdjustmentEvent.BLOCK_DECREMENT заменяет Event.SCROLL_PAGE_DOWN

Примечание: Мы рекомендуем использовать полосу прокрутки только для выбора значений. Если вы хотите реализовать прокручиваемый компонент внутри контейнера, мы рекомендуем использовать ScrollPane. Если вы используете полосу прокрутки для этой цели, вам, вероятно, придётся столкнуться с проблемами при отрисовке, обработке нажатий клавиш, определении размера и позиционировании.