Класс Scrollbar

java.lang.Object

java.awt.Component

java.awt.Scrollbar

Все реализуемые интерфейсы:: Adjustable, ImageObserver, MenuContainer, Serializable, Accessible

public class Scrollbar extends Component implements Adjustable, Accessible

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

Image shows 3 vertical sliders,
side-by-side.

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

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

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

Image shows horizontal slider with starting range of 0 and ending range
of 300. The slider thumb is labeled 60.

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

 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. Если вы используете полосу прокрутки для этой цели, вы, вероятно, столкнётесь с проблемами при отрисовке, обработке клавиш, определении размера и позиционировании.

С:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`Scrollbar.AccessibleAWTScrollBar`	Этот класс реализует поддержку доступности для класса `Scrollbar`.

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

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

Модификатор и тип	Поле	Описание
`static final int`	`HORIZONTAL`	Константа, указывающая на горизонтальную полосу прокрутки.
`static final int`	`VERTICAL`	Константа, указывающая на вертикальную полосу прокрутки.

Поля, объявленные в классе java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.Adjustable

NO_ORIENTATION

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

Конструктор	Описание
`Scrollbar()`	Создаёт новую вертикальную полосу прокрутки.
`Scrollbar(int orientation)`	Создаёт новую полосу прокрутки с указанной ориентацией.
`Scrollbar(int orientation, int value, int visible, int minimum, int maximum)`	Создаёт новую полосу прокрутки с указанной ориентацией, начальным значением, видимым объёмом и минимальными и максимальными значениями.

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

Модификатор и тип	Метод	Описание
`void`	`addAdjustmentListener(AdjustmentListener l)`	Добавляет указанного слушателя изменений для получения экземпляров `AdjustmentEvent` от этой полосы прокрутки.
`void`	`addNotify()`	Создаёт компонент полосы прокрутки.
`AccessibleContext`	`getAccessibleContext()`	Получает `AccessibleContext`, связанный с этой полосой прокрутки.
`AdjustmentListener[]`	`getAdjustmentListeners()`	Возвращает массив всех зарегистрированных слушателей изменений на этой полосе прокрутки.
`int`	`getBlockIncrement()`	Получает блочный шаг этой полосы прокрутки.
`int`	`getLineIncrement()`	Устарело. Начиная с JDK версии 1.1, заменено на `getUnitIncrement()`.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, в настоящее время зарегистрированных как `FooListener` на этой полосе прокрутки.
`int`	`getMaximum()`	Получает максимальное значение этой полосы прокрутки.
`int`	`getMinimum()`	Получает минимальное значение этой полосы прокрутки.
`int`	`getOrientation()`	Возвращает ориентацию этой полосы прокрутки.
`int`	`getPageIncrement()`	Устарело. Начиная с JDK версии 1.1, заменено на `getBlockIncrement()`.
`int`	`getUnitIncrement()`	Получает единичный шаг для этой полосы прокрутки.
`int`	`getValue()`	Получает текущее значение этой полосы прокрутки.
`boolean`	`getValueIsAdjusting()`	Возвращает true, если значение находится в процессе изменения в результате действий пользователя.
`int`	`getVisible()`	Устарело. Начиная с JDK версии 1.1, заменено на `getVisibleAmount()`.
`int`	`getVisibleAmount()`	Получает видимый объём этой полосы прокрутки.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этой полосы прокрутки.
`protected void`	`processAdjustmentEvent(AdjustmentEvent e)`	Обрабатывает события изменения, возникающие на этой полосе прокрутки, рассылаемые всем зарегистрированным объектам-слушателям изменений.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события на этой полосе прокрутки.
`void`	`removeAdjustmentListener(AdjustmentListener l)`	Удаляет указанного слушателя изменений, чтобы он больше не получал экземпляры `AdjustmentEvent` от этой полосы прокрутки.
`void`	`setBlockIncrement(int v)`	Устанавливает блочный шаг для этой полосы прокрутки.
`void`	`setLineIncrement(int v)`	Устарело. Начиная с JDK версии 1.1, заменено на `setUnitIncrement(int)`.
`void`	`setMaximum(int newMaximum)`	Устанавливает максимальное значение этой полосы прокрутки.
`void`	`setMinimum(int newMinimum)`	Устанавливает минимальное значение этой полосы прокрутки.
`void`	`setOrientation(int orientation)`	Устанавливает ориентацию для этой полосы прокрутки.
`void`	`setPageIncrement(int v)`	Устарело. Начиная с JDK версии 1.1, заменено на `setBlockIncrement()`.
`void`	`setUnitIncrement(int v)`	Устанавливает единичный шаг для этой полосы прокрутки.
`void`	`setValue(int newValue)`	Устанавливает значение этой полосы прокрутки на указанное значение.
`void`	`setValueIsAdjusting(boolean b)`	Устанавливает свойство `valueIsAdjusting`.
`void`	`setValues(int value, int visible, int minimum, int maximum)`	Устанавливает значения четырёх свойств для этой полосы прокрутки: `value`, `visibleAmount`, `minimum` и `maximum`.
`void`	`setVisibleAmount(int newAmount)`	Устанавливает видимый объём этой полосы прокрутки.

Методы, объявленные в классе java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

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

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

HORIZONTAL

public static final int HORIZONTAL

Константа, указывающая на горизонтальную полосу прокрутки.

См. также:

VERTICAL

public static final int VERTICAL

Константа, указывающая на вертикальную полосу прокрутки.

См. также:

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

Scrollbar

public Scrollbar() throws HeadlessException

Создаёт новую вертикальную полосу прокрутки. Стандартные свойства полосы прокрутки перечислены в следующей таблице:

Стандартные свойства полосы прокрутки
Свойство	Описание	Значение по умолчанию
orientation	указывает, является ли полоса прокрутки вертикальной или горизонтальной	`Scrollbar.VERTICAL`
value	значение, которое управляет расположением области полосы прокрутки	0
visible amount	видимая часть диапазона полосы прокрутки, обычно представленная размером области полосы прокрутки	10
minimum	минимальное значение полосы прокрутки	0
maximum	максимальное значение полосы прокрутки	100
unit increment	величина изменения значения при нажатии клавиш "Вверх" или "Вниз" или при нажатии на стрелки полосы прокрутки	1
block increment	величина изменения значения при нажатии клавиш "Страница вверх" или "Страница вниз" или при щелчке по области полосы прокрутки по обе стороны от области	10

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

Scrollbar

public Scrollbar(int orientation) throws HeadlessException

Создаёт новую полосу прокрутки с указанной ориентацией.

Аргумент orientation должен принимать одно из двух значений Scrollbar.HORIZONTAL или Scrollbar.VERTICAL, указывающих на горизонтальную или вертикальную полосу прокрутки соответственно.

Параметры:

orientation - указывает ориентацию полосы прокрутки

Исключение:

IllegalArgumentException - при передаче недопустимого значения для аргумента orientation

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

Scrollbar

public Scrollbar(int orientation, int value, int visible, int minimum, int maximum) throws HeadlessException

Создаёт новую полосу прокрутки с указанной ориентацией, начальным значением, видимой частью, минимальными и максимальными значениями.

Параметры, переданные в этот конструктор, подчиняются ограничениям, описанным в setValues(int, int, int, int).

Параметры:

orientation - указывает ориентацию полосы прокрутки.

value - начальное значение полосы прокрутки

visible - видимая часть полосы прокрутки, обычно представленная размером области

minimum - минимальное значение полосы прокрутки

maximum - максимальное значение полосы прокрутки

Исключение:

IllegalArgumentException - при передаче недопустимого значения для аргумента orientation

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

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

addNotify

public void addNotify()

Создаёт представителя полосы прокрутки. Представитель позволяет изменять внешний вид полосы прокрутки без изменения её функциональности.

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

addNotify в классе Component

См. также:

getOrientation

public int getOrientation()

Возвращает ориентацию полосы прокрутки.

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

getOrientation в интерфейсе Adjustable

Возвращает:

ориентацию полосы прокрутки, либо Scrollbar.HORIZONTAL, либо Scrollbar.VERTICAL

См. также:

setOrientation

public void setOrientation(int orientation)

Устанавливает ориентацию полосы прокрутки.

Параметры:

orientation - ориентация полосы прокрутки, либо Scrollbar.HORIZONTAL, либо Scrollbar.VERTICAL

Исключение:

IllegalArgumentException - если переданное значение для orientation не является допустимым

С:

1.1

См. также:

getValue

public int getValue()

Возвращает текущее значение полосы прокрутки.

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

getValue в интерфейсе Adjustable

Возвращает:

текущее значение полосы прокрутки

См. также:

setValue

public void setValue(int newValue)

Устанавливает значение полосы прокрутки.

Если переданное значение меньше текущего minimum или больше текущего maximum - visibleAmount, то подставляется либо minimum, либо maximum - visibleAmount соответственно.

Обычно программа должна изменять значение полосы прокрутки только вызывая setValues. Метод setValues одновременно и синхронно устанавливает свойства минимального, максимального значения, видимой части и значения полосы прокрутки, чтобы они были взаимосвязаны.

Вызов этого метода не генерирует событие AdjustmentEvent.

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

setValue в интерфейсе Adjustable

Параметры:

newValue - новое значение полосы прокрутки

См. также:

getMinimum

public int getMinimum()

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

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

getMinimum в интерфейсе Adjustable

Возвращает:

минимальное значение полосы прокрутки

См. также:

setMinimum

public void setMinimum(int newMinimum)

Устанавливает минимальное значение полосы прокрутки.

При вызове setMinimum, минимальное значение изменяется, а другие значения (включая максимальное, видимую часть и текущее значение полосы прокрутки) изменяются для согласованности с новым минимумом.

Обычно программа должна изменять минимальное значение полосы прокрутки только вызывая setValues. Метод setValues одновременно и синхронно устанавливает свойства минимального, максимального значения, видимой части и значения полосы прокрутки, чтобы они были взаимосвязаны.

Обратите внимание, что установка минимального значения в Integer.MAX_VALUE приведет к установке нового минимального значения в Integer.MAX_VALUE - 1.

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

setMinimum в интерфейсе Adjustable

Параметры:

newMinimum - новое минимальное значение для данной полосы прокрутки

С:

1.1

См. также:

END_OF_DOCUMENT_MARKER

getMaximum

public int getMaximum()

Получает максимальное значение этой полосы прокрутки.

Указано в:

getMaximum в интерфейсе Adjustable

Возвращает:

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

См. также:

setMaximum

public void setMaximum(int newMaximum)

Устанавливает максимальное значение этой полосы прокрутки.

При вызове setMaximum, максимальное значение изменяется, а другие значения (включая минимальное, видимое количество и текущее значение полосы прокрутки) изменяются, чтобы согласоваться с новым максимумом.

Обычно программа должна изменять максимальное значение полосы прокрутки, только вызывая setValues. Метод setValues одновременно и синхронно устанавливает свойства минимума, максимума, видимого количества и значения полосы прокрутки, чтобы они были взаимосвязаны.

Обратите внимание, что установка максимального значения в Integer.MIN_VALUE приведет к установке нового максимального значения в Integer.MIN_VALUE + 1.

Указано в:

setMaximum в интерфейсе Adjustable

Параметры:

newMaximum - новое максимальное значение для этой полосы прокрутки

С:

1.1

См. также:

getVisibleAmount

public int getVisibleAmount()

Получает видимое количество этой полосы прокрутки.

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

Пузырек полосы прокрутки может не отображаться, когда он неподвижен (например, когда он занимает всю длину дорожки полосы прокрутки или когда полоса прокрутки отключена). Отображение или отсутствие пузырька не повлияет на значение, возвращаемое getVisibleAmount.

Указано в:

getVisibleAmount в интерфейсе Adjustable

Возвращает:

видимое количество этой полосы прокрутки

С:

1.1

См. также:

getVisible

@Deprecated public int getVisible()

Устаревшее.

Начиная с версии JDK 1.1, заменено на getVisibleAmount().

Возвращает видимое количество этой полосы прокрутки.

Возвращает:: видимое количество этой полосы прокрутки

setVisibleAmount

public void setVisibleAmount(int newAmount)

Устанавливает видимое количество этой полосы прокрутки.

Если предоставленное видимое количество меньше one или больше текущего maximum - minimum, то вместо него подставляется либо one, либо maximum - minimum, соответственно.

Обычно программа должна изменять значение полосы прокрутки, только вызывая setValues. Метод setValues одновременно и синхронно устанавливает свойства минимума, максимума, видимого количества и значения полосы прокрутки, чтобы они были взаимосвязаны.

Указано в:

setVisibleAmount в интерфейсе Adjustable

Параметры:

newAmount - новое видимое количество

С:

1.1

См. также:

setUnitIncrement

public void setUnitIncrement(int v)

Устанавливает шаг изменения для этой полосы прокрутки.

Шаг изменения — это значение, которое добавляется или вычитается, когда пользователь активирует область шага изменения полосы прокрутки, обычно с помощью жеста мыши или клавиатуры, который полоса прокрутки получает как событие корректировки. Шаг изменения должен быть больше нуля. Попытки установить шаг изменения меньше 1 приведут к установке значения 1.

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

Указано в:

setUnitIncrement в интерфейсе Adjustable

Параметры:

v — величина приращения или уменьшения значения полосы прокрутки

С:

1.1

См. также:

setLineIncrement

@Deprecated public void setLineIncrement(int v)

Устаревшее.

Начиная с версии JDK 1.1, заменено на setUnitIncrement(int).

Устанавливает шаг изменения для этой полосы прокрутки.

Параметры:: v — значение приращения

getUnitIncrement

public int getUnitIncrement()

Получает шаг изменения для этой полосы прокрутки.

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

Указано в:

getUnitIncrement в интерфейсе Adjustable

Возвращает:

шаг изменения этой полосы прокрутки

С:

1.1

См. также:

getLineIncrement

@Deprecated public int getLineIncrement()

Устаревшее.

Начиная с версии JDK 1.1, заменено на getUnitIncrement().

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

Возвращает:: шаг изменения для этой полосы прокрутки

setBlockIncrement

public void setBlockIncrement(int v)

Устанавливает шаг блока для этой полосы прокрутки.

Шаг блока — это значение, которое добавляется или вычитается, когда пользователь активирует область шага блока полосы прокрутки, обычно с помощью жеста мыши или клавиатуры, который полоса прокрутки получает как событие корректировки. Шаг блока должен быть больше нуля. Попытки установить шаг блока меньше 1 приведут к установке значения 1.

Указано в:

setBlockIncrement в интерфейсе Adjustable

Параметры:

v — величина приращения или уменьшения значения полосы прокрутки

С:

1.1

См. также:

setPageIncrement

@Deprecated public void setPageIncrement(int v)

Устаревшее.

Начиная с версии JDK 1.1, заменено на setBlockIncrement().

Устанавливает шаг блока для этой полосы прокрутки.

Параметры:: v — шаг блока

getBlockIncrement

public int getBlockIncrement()

Получает шаг блока этой полосы прокрутки.

Указано в:

getBlockIncrement в интерфейсе Adjustable

Возвращает:

шаг блока этой полосы прокрутки

С:

1.1

См. также:

getPageIncrement

@Deprecated public int getPageIncrement()

Устаревшее.

Начиная с версии JDK 1.1, заменено на getBlockIncrement().

Возвращает шаг блока этой полосы прокрутки.

Возвращает:: шаг блока этой полосы прокрутки

setValues

public void setValues(int value, int visible, int minimum, int maximum)

Устанавливает значения четырёх свойств для этой полосы прокрутки: value, visibleAmount, minimum и maximum. Если предоставленные значения этих свойств несовместимы или некорректны, они будут изменены для обеспечения согласованности.

Этот метод одновременно и синхронно устанавливает значения четырёх свойств полосы прокрутки, гарантируя, что значения этих свойств взаимно согласованы. Он накладывает следующие ограничения: maximum должно быть больше, чем minimum, maximum - minimum не должно быть больше, чем Integer.MAX_VALUE, visibleAmount должно быть больше нуля. visibleAmount не должно быть больше, чем maximum - minimum, value не должно быть меньше, чем minimum, и value не должно быть больше, чем maximum - visibleAmount

Вызов этого метода не вызывает AdjustmentEvent.

Параметры:

value - позиция в текущем окне

visible - видимая часть полосы прокрутки

minimum - минимальное значение полосы прокрутки

maximum - максимальное значение полосы прокрутки

См. также:

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

Возвращает:

значение свойства valueIsAdjusting

С:

1.4

См. также:

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

Устанавливает свойство valueIsAdjusting.

Параметры:

b - новый статус изменения

С:

1.4

См. также:

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

Добавляет указанного слушателя событий изменения, чтобы получать события AdjustmentEvent от этой полосы прокрутки. Если l равно null, исключение не выбрасывается, и действие не выполняется.

См. Проблемы с потоками AWT для получения подробной информации о модели потоков AWT.

Задано в:

addAdjustmentListener в интерфейсе Adjustable

Параметры:

l - слушатель событий изменения

С:

1.1

См. также:

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

Удаляет указанного слушателя событий изменения, чтобы он больше не получал события AdjustmentEvent от этой полосы прокрутки. Если l равно null, исключение не выбрасывается, и действие не выполняется.

См. Проблемы с потоками AWT для получения подробной информации о модели потоков AWT.

Задано в:

removeAdjustmentListener в интерфейсе Adjustable

Параметры:

l - слушатель событий изменения

С:

1.1

См. также:

getAdjustmentListeners

public AdjustmentListener[] getAdjustmentListeners()

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

Возвращает:

все слушатели событий изменения этой полосы прокрутки или пустой массив, если слушатели не зарегистрированы

С:

1.4

См. также:

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, зарегистрированных в качестве слушателей FooListener на этой полосе прокрутки. Слушатели регистрируются с помощью метода addFooListener.

Вы можете указать аргумент listenerType с помощью литерала класса, например, FooListener.class. Например, вы можете получить слушателей мыши для Scrollbar c следующим образом:

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

Если таких слушателей нет, метод возвращает пустой массив.

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

getListeners в классе Component

Параметры типа:

T - тип слушателей

Параметры:

listenerType - тип запрашиваемых слушателей; этот параметр должен указать интерфейс, который наследуется от java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных в качестве слушателей FooListener на этом компоненте, или пустой массив, если такие слушатели не добавлены

Исключения:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С:

1.3

См. также:

processEvent

protected void processEvent(AWTEvent e)

Обрабатывает события на этой полосе прокрутки. Если событие является экземпляром AdjustmentEvent, оно вызывает метод processAdjustmentEvent. В противном случае оно вызывает метод processEvent своего суперкласса.

Обратите внимание, что если параметр события равен null, поведение не определено и может привести к исключению.

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

processEvent в классе Component

Параметры:

e - событие

С:

1.1

См. также:

processAdjustmentEvent

protected void processAdjustmentEvent(AdjustmentEvent e)

Обрабатывает события изменения на этой полосе прокрутки, рассылать их всем зарегистрированным слушателям событий изменения.

Этот метод не вызывается, если события изменения не включены для этого компонента. События изменения включаются, когда происходит одно из следующих событий:

Объект AdjustmentListener зарегистрирован с помощью addAdjustmentListener.
События изменения включены с помощью enableEvents.

Параметры:

e - событие изменения

С:

1.1

См. также:

paramString

protected String paramString()

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

Overrides:: paramString в классе Component
Returns:: строка параметров этой полосы прокрутки

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим Scrollbar. Для полос прокрутки AccessibleContext имеет вид AccessibleAWTScrollBar. Новый экземпляр AccessibleAWTScrollBar создается при необходимости.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleAWTScrollBar, который служит AccessibleContext этого ScrollBar
Since:: 1.3

© 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/java/awt/Scrollbar.html