Класс 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

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

С момента:

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` , связанное с этой `Scrollbar`.
`AdjustmentListener[]`	`getAdjustmentListeners()`	Возвращает массив всех зарегистрированных слушателей регулировок для этой полосы прокрутки.
`int`	`getBlockIncrement()`	Получает блок-приращение этой полосы прокрутки.
`int`	`getLineIncrement()`	Устарело. Начиная с версии JDK 1.1, заменено на `getUnitIncrement()`.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, которые в данный момент зарегистрированы в качестве `FooListener` на этой `Scrollbar`.
`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()`	Возвращает строку, представляющую состояние этой `Scrollbar`.
`protected void`	`processAdjustmentEvent(AdjustmentEvent e)`	Обрабатывает события регулировки, происходящие на этой полосе прокрутки, рассылаемые всем зарегистрированным объектам `AdjustmentListener`.
`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.

См. также:

GraphicsEnvironment.isHeadless()

Scrollbar

public Scrollbar(int orientation) throws HeadlessException

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

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

Параметры:

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

Исключение:

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

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

См. также:

GraphicsEnvironment.isHeadless()

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

Создаёт виджет-представление для Scrollbar. Виджет-представление позволяет изменять внешний вид Scrollbar без изменения его функциональности.

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

addNotify в классе Component

См. также:

getOrientation

public int getOrientation()

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

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

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

Возвращает:

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

См. также:

setOrientation(int)

setOrientation

public void setOrientation(int orientation)

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

Параметры:

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

Исключение:

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

С момента:

1.1

См. также:

getOrientation()

getValue

public int getValue()

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

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

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

Возвращает:

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

См. также:

getMinimum()
getMaximum()

setValue

public void setValue(int newValue)

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

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

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

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

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

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

Параметры:

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

См. также:

setValues(int, int, int, int)
getValue()
getMinimum()
getMaximum()

getMinimum

public int getMinimum()

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

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

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

Возвращает:

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

См. также:

getValue()
getMaximum()

setMinimum

public void setMinimum(int newMinimum)

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

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

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

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

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

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

Параметры:

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

С момента:

1.1

См. также:

setValues(int, int, int, int)
setMaximum(int)

getMaximum

public int getMaximum()

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

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

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

Возвращает:

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

См. также:

getValue()
getMinimum()

END_OF_DOCUMENT_MARKER

установитьМаксимальноеЗначение

public void setMaximum(int newMaximum)

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

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

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

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

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

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

Параметры:

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

С тех пор как:

1.1

См. также:

setValues(int, int, int, int)
setMinimum(int)

получитьВидимоеКоличество

public int getVisibleAmount()

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

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

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

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

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

Возвращает:

видимое количество этого ползунка прокрутки

С тех пор как:

1.1

См. также:

setVisibleAmount(int)

получитьВидимое

@Deprecated public int getVisible()

Устарело.

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

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

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

установитьВидимоеКоличество

public void setVisibleAmount(int newAmount)

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

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

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

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

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

Параметры:

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

С тех пор как:

1.1

См. также:

getVisibleAmount()
setValues(int, int, int, int)

установитьЕдиницуПриращения

public void setUnitIncrement(int v)

Устанавливает единицу приращения для этого ползунка прокрутки.

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

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

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

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

Параметры:

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

С тех пор как:

1.1

См. также:

getUnitIncrement()

установитьПриращениеСтроки

@Deprecated public void setLineIncrement(int v)

Устарело.

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

Устанавливает единицу приращения для этого ползунка прокрутки.

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

получитьЕдиницуПриращения

public int getUnitIncrement()

Получает единицу приращения для этого ползунка прокрутки.

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

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

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

Возвращает:

единица приращения этого ползунка прокрутки

С тех пор как:

1.1

См. также:

setUnitIncrement(int)

получитьПриращениеСтроки

@Deprecated public int getLineIncrement()

Устарело.

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

Возвращает единицу приращения для этого ползунка прокрутки.

Возвращает:: единица приращения для этого ползунка прокрутки

установитьПриращениеБлока

public void setBlockIncrement(int v)

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

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

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

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

Параметры:

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

С тех пор как:

1.1

См. также:

getBlockIncrement()

установитьПриращениеСтраницы

@Deprecated public void setPageIncrement(int v)

Устарело.

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

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

Параметры:: v - приращение блока

получитьПриращениеБлока

public int getBlockIncrement()

Получает приращение блока этого ползунка прокрутки.

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

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

Возвращает:

приращение блока этого ползунка прокрутки

С тех пор как:

1.1

См. также:

setBlockIncrement(int)

получитьПриращениеСтраницы

@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.

Parameters:

value - положение в текущем окне

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

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

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

See Also:

setMinimum(int)
setMaximum(int)
setVisibleAmount(int)
setValue(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

Returns:

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

Since:

1.4

See Also:

setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

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

Parameters:

b - новое состояние изменения

Since:

1.4

See Also:

getValueIsAdjusting()

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

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

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

Specified by:

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

Parameters:

l - слушатель изменения

Since:

1.1

See Also:

removeAdjustmentListener(java.awt.event.AdjustmentListener)
getAdjustmentListeners()
AdjustmentEvent
AdjustmentListener

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

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

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

Specified by:

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

Parameters:

l - слушатель изменения

Since:

1.1

See Also:

addAdjustmentListener(java.awt.event.AdjustmentListener)
getAdjustmentListeners()
AdjustmentEvent
AdjustmentListener

getAdjustmentListeners

public AdjustmentListener[] getAdjustmentListeners()

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

Returns:

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

Since:

1.4

See Also:

addAdjustmentListener(java.awt.event.AdjustmentListener)
removeAdjustmentListener(java.awt.event.AdjustmentListener)
AdjustmentEvent
AdjustmentListener

getListeners

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

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

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

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

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

Overrides:

getListeners в классе Component

Type Parameters:

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

Parameters:

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

Returns:

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

Throws:

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

Since:

1.3

See Also:

processEvent

protected void processEvent(AWTEvent e)

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

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

Overrides:

processEvent в классе Component

Parameters:

e - событие

Since:

1.1

See Also:

AdjustmentEvent
processAdjustmentEvent(java.awt.event.AdjustmentEvent)

processAdjustmentEvent

protected void processAdjustmentEvent(AdjustmentEvent e)

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

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

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

Parameters:

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

Since:

1.1

See Also:

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleAWTScrollBar, который является AccessibleContext этого ScrollBar
С момента:: 1.3

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/Scrollbar.html