Класс BasicScrollBarUI

javax.swing.plaf.basic.BasicScrollBarUI

Все реализуемые интерфейсы:: LayoutManager, SwingConstants

Прямые известные подклассы:: MetalScrollBarUI, SynthScrollBarUI

public class BasicScrollBarUI extends ScrollBarUI implements LayoutManager, SwingConstants

Реализация ScrollBarUI для базового оформления

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`BasicScrollBarUI.ArrowButtonListener`	Слушатель клавиш управления курсором.
`protected class`	`BasicScrollBarUI.ModelListener`	Слушатель изменений модели.
`class`	`BasicScrollBarUI.PropertyChangeHandler`	Обработчик изменения свойств
`protected class`	`BasicScrollBarUI.ScrollListener`	Слушатель событий прокрутки, инициированных в `ScrollPane`.
`protected class`	`BasicScrollBarUI.TrackListener`	Отслеживает перетаскивание мышью.

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected BasicScrollBarUI.ArrowButtonListener`	`buttonListener`	Слушатель кнопок
`protected JButton`	`decrButton`	Кнопка уменьшения
`protected static final int`	`DECREASE_HIGHLIGHT`	Подсветка уменьшения
`protected int`	`decrGap`	Расстояние между кнопкой уменьшения и дорожкой.
`protected JButton`	`incrButton`	Кнопка увеличения
`protected static final int`	`INCREASE_HIGHLIGHT`	Подсветка увеличения
`protected int`	`incrGap`	Расстояние между кнопкой увеличения и дорожкой.
`protected boolean`	`isDragging`	Перетаскивание
`protected Dimension`	`maximumThumbSize`	Максимальный размер ползунка
`protected Dimension`	`minimumThumbSize`	Минимальный размер ползунка
`protected BasicScrollBarUI.ModelListener`	`modelListener`	Слушатель модели
`protected static final int`	`NO_HIGHLIGHT`	Без подсветки
`protected PropertyChangeListener`	`propertyChangeListener`	Слушатель изменения свойств
`protected JScrollBar`	`scrollbar`	Полоса прокрутки
`protected int`	`scrollBarWidth`	Подсказка о том, какой должна быть ширина (для вертикальной полосы) или высота (для горизонтальной).
`protected BasicScrollBarUI.ScrollListener`	`scrollListener`	Слушатель прокрутки
`protected Timer`	`scrollTimer`	Таймер прокрутки
`protected Color`	`thumbColor`	Цвет ползунка
`protected Color`	`thumbDarkShadowColor`	Цвет тёмной тени ползунка
`protected Color`	`thumbHighlightColor`	Цвет подсветки ползунка
`protected Color`	`thumbLightShadowColor`	Цвет светлой тени ползунка
`protected Rectangle`	`thumbRect`	Прямоугольник ползунка
`protected Color`	`trackColor`	Цвет дорожки
`protected int`	`trackHighlight`	Подсветка дорожки
`protected Color`	`trackHighlightColor`	Цвет подсветки дорожки
`protected BasicScrollBarUI.TrackListener`	`trackListener`	Слушатель дорожки
`protected Rectangle`	`trackRect`	Прямоугольник дорожки

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

Конструктор	Описание
`BasicScrollBarUI()`	Создаёт `BasicScrollBarUI`.

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

Модификатор и тип	Метод	Описание
`void`	`addLayoutComponent(String name, Component child)`	Если диспетчер компоновки использует строку для каждого компонента, добавляет компонент `comp` в компоновку, связывая его со строкой, указанной в `name`.
`protected void`	`configureScrollBarColors()`	Настраивает цвета полосы прокрутки.
`protected BasicScrollBarUI.ArrowButtonListener`	`createArrowButtonListener()`	Создаёт слушатель кнопок со стрелками.
`protected JButton`	`createDecreaseButton(int orientation)`	Создаёт кнопку уменьшения.
`protected JButton`	`createIncreaseButton(int orientation)`	Создаёт кнопку увеличения.
`protected BasicScrollBarUI.ModelListener`	`createModelListener()`	Создаёт слушатель модели.
`protected PropertyChangeListener`	`createPropertyChangeListener()`	Создаёт слушатель изменения свойств.
`protected BasicScrollBarUI.ScrollListener`	`createScrollListener()`	Создаёт слушатель прокрутки.
`protected BasicScrollBarUI.TrackListener`	`createTrackListener()`	Создаёт слушатель дорожки.
`static ComponentUI`	`createUI(JComponent c)`	Создаёт пользовательский интерфейс.
`Dimension`	`getMaximumSize(JComponent c)`	Возвращает максимальный размер указанного компонента, подходящий для данного оформления.
`protected Dimension`	`getMaximumThumbSize()`	Возвращает наибольший допустимый размер ползунка.
`protected Dimension`	`getMinimumThumbSize()`	Возвращает наименьший допустимый размер ползунка.
`Dimension`	`getPreferredSize(JComponent c)`	Предпочтительная ширина вертикальной полосы прокрутки равна максимуму предпочтительных ширин кнопок увеличения/уменьшения (не `null`) и минимальной ширины ползунка.
`boolean`	`getSupportsAbsolutePositioning()`	Указывает, может ли пользователь перемещать ползунок в произвольное положение жестом мыши (обычно средней кнопкой мыши).
`protected Rectangle`	`getThumbBounds()`	Возвращает текущий размер и положение ползунка.
`protected Rectangle`	`getTrackBounds()`	Возвращает текущие границы дорожки, то есть пространство между кнопками увеличения и уменьшения за вычетом внутренних отступов.
`protected void`	`installComponents()`	Устанавливает компоненты.
`protected void`	`installDefaults()`	Устанавливает значения по умолчанию.
`protected void`	`installKeyboardActions()`	Устанавливает действия клавиатуры.
`protected void`	`installListeners()`	Устанавливает слушатели.
`void`	`installUI(JComponent c)`	Устанавливает пользовательский интерфейс.
`boolean`	`isThumbRollover()`	Возвращает true, если указатель мыши в данный момент находится над ползунком.
`void`	`layoutContainer(Container scrollbarContainer)`	Выполняет компоновку указанного контейнера.
`protected void`	`layoutHScrollbar(JScrollBar sb)`	Выполняет компоновку горизонтальной полосы прокрутки.
`protected void`	`layoutVScrollbar(JScrollBar sb)`	Выполняет компоновку вертикальной полосы прокрутки.
`Dimension`	`minimumLayoutSize(Container scrollbarContainer)`	Вычисляет минимальные размеры указанного контейнера с учётом содержащихся в нём компонентов.
`protected void`	`paintDecreaseHighlight(Graphics g)`	Отрисовывает подсветку уменьшения.
`protected void`	`paintIncreaseHighlight(Graphics g)`	Отрисовывает подсветку увеличения.
`protected void`	`paintThumb(Graphics g, JComponent c, Rectangle thumbBounds)`	Отрисовывает ползунок.
`protected void`	`paintTrack(Graphics g, JComponent c, Rectangle trackBounds)`	Отрисовывает дорожку.
`Dimension`	`preferredLayoutSize(Container scrollbarContainer)`	Вычисляет предпочтительные размеры указанного контейнера с учётом содержащихся в нём компонентов.
`void`	`removeLayoutComponent(Component child)`	Удаляет указанный компонент из компоновки.
`protected void`	`scrollByBlock(int direction)`	Выполняет прокрутку на блок.
`protected void`	`scrollByUnit(int direction)`	Выполняет прокрутку на единицу.
`protected void`	`setThumbBounds(int x, int y, int width, int height)`	Задаёт границы ползунка и принудительно перерисовывает область, включающую старые и новые границы ползунка.
`protected void`	`setThumbRollover(boolean active)`	Задаёт, находится ли указатель мыши в данный момент над ползунком.
`protected void`	`uninstallComponents()`	Удаляет компоненты.
`protected void`	`uninstallDefaults()`	Удаляет значения по умолчанию.
`protected void`	`uninstallKeyboardActions()`	Удаляет действия клавиатуры.
`protected void`	`uninstallListeners()`	Удаляет слушатели.
`void`	`uninstallUI(JComponent c)`	Удаляет пользовательский интерфейс.

Методы, объявленные в классе ComponentUI

contains, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMinimumSize, paint, update

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

minimumThumbSize

protected Dimension minimumThumbSize

Минимальный размер бегунка

maximumThumbSize

protected Dimension maximumThumbSize

Максимальный размер бегунка

thumbHighlightColor

protected Color thumbHighlightColor

Цвет подсветки бегунка

thumbLightShadowColor

protected Color thumbLightShadowColor

Цвет светлой тени бегунка

thumbDarkShadowColor

protected Color thumbDarkShadowColor

Цвет темной тени бегунка

thumbColor

protected Color thumbColor

Цвет бегунка

trackColor

protected Color trackColor

Цвет дорожки

trackHighlightColor

protected Color trackHighlightColor

Цвет подсветки дорожки

scrollbar

protected JScrollBar scrollbar

Полоса прокрутки

incrButton

protected JButton incrButton

Кнопка увеличения

decrButton

protected JButton decrButton

Кнопка уменьшения

isDragging

protected boolean isDragging

Перетаскивание

trackListener

protected BasicScrollBarUI.TrackListener trackListener

Слушатель дорожки

buttonListener

protected BasicScrollBarUI.ArrowButtonListener buttonListener

Слушатель кнопки

modelListener

protected BasicScrollBarUI.ModelListener modelListener

Слушатель модели

thumbRect

protected Rectangle thumbRect

Прямоугольник бегунка

trackRect

protected Rectangle trackRect

Прямоугольник дорожки

trackHighlight

protected int trackHighlight

Подсветка дорожки

NO_HIGHLIGHT

protected static final int NO_HIGHLIGHT

Без подсветки

См. также:

DECREASE_HIGHLIGHT

protected static final int DECREASE_HIGHLIGHT

Подсветка уменьшения

См. также:

INCREASE_HIGHLIGHT

protected static final int INCREASE_HIGHLIGHT

Подсветка увеличения

См. также:

scrollListener

protected BasicScrollBarUI.ScrollListener scrollListener

Слушатель прокрутки

propertyChangeListener

protected PropertyChangeListener propertyChangeListener

Слушатель изменений свойств

scrollTimer

protected Timer scrollTimer

Таймер прокрутки

scrollBarWidth

protected int scrollBarWidth

Подсказка о том, какой должна быть ширина (для вертикальной полосы) или высота (для горизонтальной полосы).

Начиная с:: 1.7

incrGap

protected int incrGap

Расстояние между кнопкой увеличения и дорожкой. Может быть отрицательным. Если значение отрицательное, кнопка и дорожка будут перекрываться, что удобно для кнопок нестандартной формы.

Начиная с:: 1.7

decrGap

protected int decrGap

Расстояние между кнопкой уменьшения и дорожкой. Может быть отрицательным. Если значение отрицательное, кнопка и дорожка будут перекрываться, что удобно для кнопок нестандартной формы.

Начиная с:: 1.7

Подробное описание конструкторов

BasicScrollBarUI

public BasicScrollBarUI()

Создает BasicScrollBarUI.

Подробное описание методов

createUI

public static ComponentUI createUI(JComponent c)

Создает пользовательский интерфейс.

Параметры:: c — компонент
Возвращает:: пользовательский интерфейс

configureScrollBarColors

protected void configureScrollBarColors()

Настраивает цвета полосы прокрутки.

installUI

public void installUI(JComponent c)

Устанавливает пользовательский интерфейс.

Переопределяет:

installUI в классе ComponentUI

Параметры:

c — компонент

См. также:

uninstallUI

public void uninstallUI(JComponent c)

Удаляет пользовательский интерфейс.

Переопределяет:

uninstallUI в классе ComponentUI

Параметры:

c — компонент

См. также:

installDefaults

protected void installDefaults()

Устанавливает значения по умолчанию.

installComponents

protected void installComponents()

Устанавливает компоненты.

uninstallComponents

protected void uninstallComponents()

Удаляет компоненты.

installListeners

protected void installListeners()

Устанавливает слушатели.

installKeyboardActions

protected void installKeyboardActions()

Устанавливает действия клавиатуры.

uninstallKeyboardActions

protected void uninstallKeyboardActions()

Удаляет действия клавиатуры.

uninstallListeners

protected void uninstallListeners()

Удаляет слушатели.

uninstallDefaults

protected void uninstallDefaults()

Удаляет значения по умолчанию.

createTrackListener

protected BasicScrollBarUI.TrackListener createTrackListener()

Создает слушатель дорожки.

Возвращает:: слушатель дорожки

createArrowButtonListener

protected BasicScrollBarUI.ArrowButtonListener createArrowButtonListener()

Создает слушатель кнопки со стрелкой.

Возвращает:: слушатель кнопки со стрелкой

createModelListener

protected BasicScrollBarUI.ModelListener createModelListener()

Создает слушатель модели.

Возвращает:: слушатель модели

createScrollListener

protected BasicScrollBarUI.ScrollListener createScrollListener()

Создает слушатель прокрутки.

Возвращает:: слушатель прокрутки

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()

Создает слушатель изменений свойств.

Возвращает:: слушатель изменений свойств

setThumbRollover

protected void setThumbRollover(boolean active)

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

Параметры:: active — значение true означает, что бегунок активен в данный момент.
Начиная с:: 1.5

isThumbRollover

public boolean isThumbRollover()

Возвращает true, если указатель мыши в данный момент находится над бегунком.

Возвращает:: true, если бегунок активен в данный момент
Начиная с:: 1.5

getPreferredSize

public Dimension getPreferredSize(JComponent c)

Предпочтительная ширина вертикальной полосы прокрутки равна максимальной из предпочтительных ширин кнопок увеличения и уменьшения (за исключением null) и минимальной ширины бегунка. Предпочтительная высота равна сумме предпочтительных высот тех же частей. Предпочтительный размер горизонтальной полосы прокрутки определяется аналогичным образом.

preferredSize вычисляется только один раз; при последующих вызовах этого метода возвращается кэшированный размер.

Переопределяет:

getPreferredSize в классе ComponentUI

Параметры:

c — JScrollBar, делегирующий нам этот метод

Возвращает:

предпочтительный размер Basic JScrollBar

См. также:

getMaximumSize

public Dimension getMaximumSize(JComponent c)

Описание скопировано из класса: ComponentUI

Возвращает максимальный размер указанного компонента, подходящий для данного оформления. Если возвращается null, максимальный размер будет рассчитан менеджером компоновки компонента (это предпочтительный подход для любого компонента с установленным специализированным менеджером компоновки). Реализация по умолчанию вызывает getPreferredSize и возвращает полученное значение.

Переопределяет:

getMaximumSize в классе ComponentUI

Параметры:

c — JScrollBar, делегирующий нам этот метод.

Возвращает:

new Dimension(Integer.MAX_VALUE, Integer.MAX_VALUE);

См. также:

createDecreaseButton

protected JButton createDecreaseButton(int orientation)

Создает кнопку уменьшения.

Параметры:: orientation — ориентация
Возвращает:: кнопка уменьшения

createIncreaseButton

protected JButton createIncreaseButton(int orientation)

Создает кнопку увеличения.

Параметры:: orientation — ориентация
Возвращает:: кнопка увеличения

paintDecreaseHighlight

protected void paintDecreaseHighlight(Graphics g)

Отрисовывает подсветку уменьшения.

Параметры:: g — графический контекст

paintIncreaseHighlight

protected void paintIncreaseHighlight(Graphics g)

Отрисовывает подсветку увеличения.

Параметры:: g — графический контекст

paintTrack

protected void paintTrack(Graphics g, JComponent c, Rectangle trackBounds)

Отрисовывает дорожку.

Параметры:: g — графический контекст; c — компонент; trackBounds — границы дорожки

paintThumb

protected void paintThumb(Graphics g, JComponent c, Rectangle thumbBounds)

Отрисовывает бегунок.

Параметры:: g — графический контекст; c — компонент; thumbBounds — границы бегунка

getMinimumThumbSize

protected Dimension getMinimumThumbSize()

Возвращает наименьший допустимый размер бегунка. Если полоса прокрутки станет настолько маленькой, что этот размер будет недоступен, бегунок будет скрыт.

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

Возвращает:

Наименьший допустимый размер бегунка.

См. также:

getMaximumThumbSize

protected Dimension getMaximumThumbSize()

Возвращает наибольший допустимый размер бегунка. Чтобы создать бегунок фиксированного размера, можно переопределить этот метод и getMinimumThumbSize так, чтобы они возвращали одинаковые значения.

Возвращает:

Наибольший допустимый размер бегунка.

См. также:

addLayoutComponent

public void addLayoutComponent(String name, Component child)

Описание скопировано из интерфейса: LayoutManager

Если менеджер компоновки использует строку для каждого компонента, добавляет компонент comp в компоновку и связывает его со строкой, указанной в name.

Определено в:: addLayoutComponent в интерфейсе LayoutManager
Параметры:: name — строка, связываемая с компонентом; child — добавляемый компонент

removeLayoutComponent

public void removeLayoutComponent(Component child)

Описание скопировано из интерфейса: LayoutManager

Удаляет указанный компонент из компоновки.

Определено в:: removeLayoutComponent в интерфейсе LayoutManager
Параметры:: child — удаляемый компонент

preferredLayoutSize

public Dimension preferredLayoutSize(Container scrollbarContainer)

Описание скопировано из интерфейса: LayoutManager

Вычисляет предпочтительные размеры указанного контейнера с учетом содержащихся в нем компонентов.

Определено в:

preferredLayoutSize в интерфейсе LayoutManager

Параметры:

scrollbarContainer — компонуемый контейнер

Возвращает:

предпочтительный размер контейнера

См. также:

minimumLayoutSize

public Dimension minimumLayoutSize(Container scrollbarContainer)

Описание скопировано из интерфейса: LayoutManager

Вычисляет минимальные размеры указанного контейнера с учетом содержащихся в нем компонентов.

Определено в:

minimumLayoutSize в интерфейсе LayoutManager

Параметры:

scrollbarContainer — компонуемый компонент

Возвращает:

минимальный размер контейнера

См. также:

layoutVScrollbar

protected void layoutVScrollbar(JScrollBar sb)

Выполняет компоновку вертикальной полосы прокрутки.

Параметры:: sb — полоса прокрутки

layoutHScrollbar

protected void layoutHScrollbar(JScrollBar sb)

Выполняет компоновку горизонтальной полосы прокрутки.

Параметры:: sb — полоса прокрутки

layoutContainer

public void layoutContainer(Container scrollbarContainer)

Описание скопировано из интерфейса: LayoutManager

Выполняет компоновку указанного контейнера.

Определено в:: layoutContainer в интерфейсе LayoutManager
Параметры:: scrollbarContainer — компонуемый контейнер

setThumbBounds

protected void setThumbBounds(int x, int y, int width, int height)

Задает границы бегунка и принудительно запускает перерисовку, охватывающую старые и новые границы бегунка.

Параметры:

x — задает координату x бегунка

y — задает координату y бегунка

width — задает ширину бегунка

height — задает высоту бегунка

См. также:

getThumbBounds

protected Rectangle getThumbBounds()

Возвращает текущие размер и положение бегунка.

Предупреждение : возвращаемое этим методом значение не следует изменять: это ссылка на фактический прямоугольник, а не его копия.

Возвращает:

Текущие размер и положение бегунка.

См. также:

getTrackBounds

protected Rectangle getTrackBounds()

Возвращает текущие границы дорожки, то есть пространство между кнопками увеличения и уменьшения за вычетом внутренних отступов. Значение, возвращаемое этим методом, обновляется при каждой компоновке (проверке) полосы прокрутки.

Возвращает:

текущие границы дорожки полосы прокрутки

См. также:

scrollByBlock

protected void scrollByBlock(int direction)

Выполняет прокрутку на один блок.

Параметры:: direction — направление прокрутки

scrollByUnit

protected void scrollByUnit(int direction)

Выполняет прокрутку на одну единицу.

Параметры:: direction — направление прокрутки

getSupportsAbsolutePositioning

public boolean getSupportsAbsolutePositioning()

Указывает, может ли пользователь точно позиционировать бегунок с помощью жеста мышью (обычно средней кнопкой мыши).

Возвращает:: true, если жест мышью позволяет точно позиционировать бегунок
Начиная с:: 1.5

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/plaf/basic/BasicScrollBarUI.html