Класс JScrollBar

javax.swing.JScrollBar

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

Непосредственные известные подклассы:: JScrollPane.ScrollBar

@JavaBean(defaultProperty="UI", description="A component that helps determine the visible content range of an area.") public class JScrollBar extends JComponent implements Adjustable, Accessible

Реализация полосы прокрутки. Пользователь перемещает ползунок в полосе прокрутки для определения содержимого области просмотра. Программа, как правило, настраивает отображение так, что конец полосы прокрутки соответствует концу отображаемого содержимого, или 100% содержимого. Начало полосы прокрутки — это начало отображаемого содержимого, или 0%. Положение ползунка в этих пределах затем переводится в соответствующий процент отображаемого содержимого.

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

Предупреждение: Swing не потокобезопасен. Более подробная информация находится в Политике потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. С версии 1.4 была добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. XMLEncoder.

С:

1.2

См. также:

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

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

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected int`	`blockIncrement`	Хранит величину изменения значения ползунка при запросе блока (обычно "страницы") вверх/вниз.
`protected BoundedRangeModel`	`model`	Модель, представляющая минимальное, максимальное значения, область (также "visibleAmount") и текущее значение ползунка.
`protected int`	`orientation`	Ориентация этого ползунка.
`protected int`	`unitIncrement`	Хранит величину изменения значения ползунка при запросе единичного перемещения вверх/вниз.

Поля, объявленные в классе javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

HORIZONTAL, NO_ORIENTATION, VERTICAL

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

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

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

Конструктор	Описание
`JScrollBar()`	Создаёт вертикальный ползунок со следующими начальными значениями:
`JScrollBar(int orientation)`	Создаёт ползунок с заданной ориентацией и следующими начальными значениями:
`JScrollBar(int orientation, int value, int extent, int min, int max)`	Создаёт ползунок с заданной ориентацией, значением, объёмом, минимумом и максимумом.

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

Модификатор и тип	Метод	Описание
`void`	`addAdjustmentListener(AdjustmentListener l)`	Добавляет AdjustmentListener.
`protected void`	`fireAdjustmentValueChanged(int id, int type, int value)`	Уведомляет слушателей о том, что модель ползунка изменилась.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JScrollBar.
`AdjustmentListener[]`	`getAdjustmentListeners()`	Возвращает массив всех `AdjustmentListener`, добавленных к этому JScrollBar с помощью addAdjustmentListener().
`int`	`getBlockIncrement()`	Для обратной совместимости с java.awt.Scrollbar.
`int`	`getBlockIncrement(int direction)`	Возвращает величину изменения значения ползунка при запросе блока (обычно "страницы") вверх/вниз.
`int`	`getMaximum()`	Максимальное значение ползунка равно максимуму минус область.
`Dimension`	`getMaximumSize()`	Возвращает максимальный размер для `JScrollBar`.
`int`	`getMinimum()`	Возвращает минимальное значение, поддерживаемое ползунком (обычно ноль).
`Dimension`	`getMinimumSize()`	Возвращает минимальный размер для `JScrollBar`.
`BoundedRangeModel`	`getModel()`	Возвращает модель данных, которая обрабатывает четыре фундаментальных свойства ползунка: минимум, максимум, значение, область.
`int`	`getOrientation()`	Возвращает ориентацию компонента (горизонтальная или вертикальная).
`ScrollBarUI`	`getUI()`	Возвращает делегата, который реализует внешний вид для этого компонента.
`String`	`getUIClassID()`	Возвращает имя класса LookAndFeel для этого компонента.
`int`	`getUnitIncrement()`	Для обратной совместимости с java.awt.Scrollbar.
`int`	`getUnitIncrement(int direction)`	Возвращает величину изменения значения ползунка при запросе единичного перемещения вверх/вниз.
`int`	`getValue()`	Возвращает значение ползунка.
`boolean`	`getValueIsAdjusting()`	Истина, если ползунок перетаскивается.
`int`	`getVisibleAmount()`	Возвращает область ползунка, также известную как его "visibleAmount".
`protected String`	`paramString()`	Возвращает строковое представление этого JScrollBar.
`void`	`removeAdjustmentListener(AdjustmentListener l)`	Удаляет слушателя AdjustmentEvent.
`void`	`setBlockIncrement(int blockIncrement)`	Устанавливает свойство blockIncrement.
`void`	`setEnabled(boolean x)`	Включает компонент, чтобы положение ползунка можно было изменить.
`void`	`setMaximum(int maximum)`	Устанавливает свойство maximum модели.
`void`	`setMaximumSize(Dimension maximumSize)`	В отличие от большинства компонентов, `JScrollBar` вычисляет максимальный размер исходя из предпочтительного размера по одной оси и фиксированного максимального размера по другой.
`void`	`setMinimum(int minimum)`	Устанавливает свойство minimum модели.
`void`	`setMinimumSize(Dimension minimumSize)`	В отличие от большинства компонентов, `JScrollBar` вычисляет минимальный размер исходя из предпочтительного размера по одной оси и фиксированного минимального размера по другой.
`void`	`setModel(BoundedRangeModel newModel)`	Устанавливает модель, которая обрабатывает четыре фундаментальных свойства ползунка: минимум, максимум, значение, область.
`void`	`setOrientation(int orientation)`	Устанавливает ориентацию ползунка на VERTICAL или HORIZONTAL.
`void`	`setUI(ScrollBarUI ui)`	Устанавливает объект L&F, который отрисовывает этот компонент.
`void`	`setUnitIncrement(int unitIncrement)`	Устанавливает свойство unitIncrement.
`void`	`setValue(int value)`	Устанавливает значение ползунка.
`void`	`setValueIsAdjusting(boolean b)`	Устанавливает свойство valueIsAdjusting модели.
`void`	`setValues(int newValue, int newExtent, int newMin, int newMax)`	Устанавливает четыре свойства BoundedRangeModel после принудительного соответствия аргументов обычным ограничениям:
`void`	`setVisibleAmount(int extent)`	Устанавливает свойство extent модели.
`void`	`updateUI()`	Переопределяет `JComponent.updateUI`.

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

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

model

protected BoundedRangeModel model

Модель, представляющая минимальное, максимальное, текущее значение и объем прокручиваемой области (также известный как "видимый объем") полосы прокрутки.

См. также:

orientation

protected int orientation

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

См. также:

unitIncrement

protected int unitIncrement

Содержит величину изменения значения полосы прокрутки при запросе единичного шага вверх/вниз.

См. также:

blockIncrement

protected int blockIncrement

Содержит величину изменения значения полосы прокрутки при запросе шага блока (обычно "страницы") вверх/вниз.

См. также:

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

JScrollBar

public JScrollBar(int orientation, int value, int extent, int min, int max)

Создает полосу прокрутки с указанным направлением, значением, объемом, минимумом и максимумом. "Объем" - это размер отображаемой области. Он также известен как "видимый объем".

Примечание: Используйте setBlockIncrement для установки шага блока, немного меньшего, чем объем просмотра. Таким образом, когда пользователь перемещает ползунок в смежное положение, одна или две строки исходного содержимого остаются в поле зрения.

Параметры:

orientation - направление JScrollBar

value - текущее значение

extent - величина изменения значения

min - минимальное значение

max - максимальное значение

Исключения:

IllegalArgumentException - если направление не VERTICAL или HORIZONTAL

См. также:

JScrollBar

public JScrollBar(int orientation)

Создает полосу прокрутки с указанным направлением и следующими начальными значениями:

 minimum = 0
 maximum = 100
 value = 0
 extent = 10

Параметры:: orientation - направление JScrollBar

JScrollBar

public JScrollBar()

Создает вертикальную полосу прокрутки со следующими начальными значениями:

 minimum = 0
 maximum = 100
 value = 0
 extent = 10

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

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel") public void setUI(ScrollBarUI ui)

Устанавливает объект L&F, который отображает этот компонент.

Параметры:

ui - объект L&F ScrollBarUI

С:

1.4

См. также:

getUI

public ScrollBarUI getUI()

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

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

getUI в классе JComponent

Возвращает:

текущий UI полосы прокрутки.

См. также:

updateUI

public void updateUI()

Переопределяет JComponent.updateUI.

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

updateUI в классе JComponent

См. также:

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

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

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

getUIClassID в классе JComponent

Возвращает:

строку "ScrollBarUI"

См. также:

getOrientation

public int getOrientation()

Возвращает направление компонента (горизонтальное или вертикальное).

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

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

Возвращает:

VERTICAL или HORIZONTAL

См. также:

setOrientation

@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JScrollBar.VERTICAL","JScrollBar.HORIZONTAL"}, description="The scrollbar's orientation.") public void setOrientation(int orientation)

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

Параметры:

orientation - направление JScrollBar

Исключения:

IllegalArgumentException - если направление не VERTICAL или HORIZONTAL

См. также:

getModel

public BoundedRangeModel getModel()

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

Возвращает:

модель данных

См. также:

setModel

@BeanProperty(expert=true, description="The scrollbar's BoundedRangeModel.") public void setModel(BoundedRangeModel newModel)

Устанавливает модель, которая обрабатывает четыре основных свойства полосы прокрутки: минимум, максимум, значение, объем.

Параметры:

newModel - новая модель

См. также:

getUnitIncrement

public int getUnitIncrement(int direction)

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

Компонент JScrollPane создает полосы прокрутки (по умолчанию), которые переопределяют этот метод и делегируют запросы к просматриваемой области Scrollable view, если она есть. Интерфейс Scrollable предоставляет более специализированную версию этого метода.

Некоторые реализации виджетов, которые предоставляют пользовательское поведение прокрутки, игнорируют этот параметр.

Параметры:

direction - -1 или 1 для запросов вверх/вниз соответственно

Возвращает:

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

См. также:

setUnitIncrement

@BeanProperty(preferred=true, description="The scrollbar's unit increment.") public void setUnitIncrement(int unitIncrement)

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

Примечание: если аргумент равен значению Integer.MIN_VALUE, то большинство реализаций виджетов не будут предоставлять прокрутку вправо/вниз.

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

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

Параметры:

unitIncrement - шаг изменения

См. также:

getBlockIncrement

public int getBlockIncrement(int direction)

Возвращает величину изменения значения полосы прокрутки, заданную блоком (обычно «страница») вверх/вниз. Реализация ScrollBarUI обычно вызывает этот метод, когда пользователь щелкает вне «кнопки» полосы прокрутки, чтобы прокрутить вверх или вниз на большое количество. Подклассы могут переопределить этот метод, чтобы вычислить значение, например, изменение, необходимое для прокрутки одного абзаца в текстовом документе.

Компонент JScrollPane создает полосы прокрутки (по умолчанию), которые переопределяют этот метод и передают запрос вьюпорту Scrollable view, если он есть. Интерфейс Scrollable предоставляет более специализированную версию этого метода.

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

Параметры:

direction - значение -1 или 1 для вверх/вниз соответственно

Возвращает:

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

См. также:

setBlockIncrement

@BeanProperty(preferred=true, description="The scrollbar's block increment.") public void setBlockIncrement(int blockIncrement)

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

Обратите внимание, что если аргумент равен значению Integer.MIN_VALUE, то большинство реализаций внешнего вида не обеспечат прокрутку вправо/вниз.

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

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

Параметры:

blockIncrement - величина блока прокрутки

См. также:

getUnitIncrement

public int getUnitIncrement()

Для обеспечения обратной совместимости с java.awt.Scrollbar.

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

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

Возвращает:

значение единичного увеличения для настраиваемого объекта

См. также:

getBlockIncrement

public int getBlockIncrement()

Для обеспечения обратной совместимости с java.awt.Scrollbar.

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

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

Возвращает:

значение увеличения блока для настраиваемого объекта

См. также:

getValue

public int getValue()

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

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

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

Возвращает:

свойство значения модели

См. также:

setValue

@BeanProperty(bound=false, preferred=true, description="The scrollbar's current value.") public void setValue(int value)

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

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

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

Параметры:

value - текущее значение, между minimum и maximum - visibleAmount

См. также:

getVisibleAmount

public int getVisibleAmount()

Возвращает размер полосы прокрутки, также известный как «visibleAmount». В многих реализациях внешнего вида полосы прокрутки размер «кнопки» или «ползунка» пропорционален размеру.

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

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

Возвращает:

значение свойства extent модели

См. также:

setVisibleAmount

@BeanProperty(bound=false, preferred=true, description="The amount of the view that is currently visible.") public void setVisibleAmount(int extent)

Устанавливает свойство extent модели.

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

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

Параметры:

extent - длина индикатора

См. также:

getMinimum

public int getMinimum()

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

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

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

Возвращает:

значение свойства minimum модели

См. также:

setMinimum

@BeanProperty(bound=false, preferred=true, description="The scrollbar's minimum value.") public void setMinimum(int minimum)

Устанавливает свойство minimum модели.

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

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

Параметры:

minimum - минимальное значение

См. также:

getMaximum

public int getMaximum()

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

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

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

Возвращает:

значение свойства maximum модели

См. также:

setMaximum

@BeanProperty(bound=false, preferred=true, description="The scrollbar's maximum value.") public void setMaximum(int maximum)

Устанавливает свойство maximum модели. Обратите внимание, что значение полосы прокрутки может быть установлено только до максимального значения - extent.

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

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

Параметры:

maximum - максимальное значение

См. также:

getValueIsAdjusting

public boolean getValueIsAdjusting()

Истинно, если ползунок полосы прокрутки перетаскивается.

Возвращает:

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

См. также:

setValueIsAdjusting

@BeanProperty(bound=false, expert=true, description="True if the scrollbar thumb is being dragged.") public void setValueIsAdjusting(boolean b)

Устанавливает свойство valueIsAdjusting модели. Реализации внешнего вида полосы прокрутки должны устанавливать это свойство в true при начале перетаскивания ползунка и в false при завершении перетаскивания. Модель полосы прокрутки не будет генерировать ChangeEvents, пока значение valueIsAdjusting равно true.

Параметры:

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

См. также:

setValues

public void setValues(int newValue, int newExtent, int newMin, int newMax)

Устанавливает четыре свойства BoundedRangeModel после принудительного соответствия аргументов обычным ограничениям:

 minimum ≤ value ≤ value+extent ≤ maximum

Параметры:

newValue - целое число, представляющее текущее значение

newExtent - целое число, представляющее величину «скачка» значения

newMin - целое число, представляющее минимальное значение

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

См. также:

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

Добавляет AdjustmentListener. Слушатели Adjustment уведомляются каждый раз, когда изменяется модель полосы прокрутки. События Adjustment предоставляются для обратной совместимости с java.awt.Scrollbar.

Обратите внимание, что свойство типа AdjustmentEvents всегда будет иметь значение по умолчанию AdjustmentEvent.TRACK, потому что все изменения значения BoundedRangeModels считаются эквивалентными. Для изменения значения BoundedRangeModel достаточно установить его свойство value, т.е. model.setValue(123). Информация об источнике изменения, например, о уменьшении блока, не предоставляется. Мы не пытаемся определить источник изменения.

Specified by:

addAdjustmentListener in interface Adjustable

Parameters:

l - добавляемый AdjustmentLister

See Also:

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

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

Specified by:

removeAdjustmentListener in interface Adjustable

Parameters:

l - удаляемый AdjustmentLister

See Also:

getAdjustmentListeners

@BeanProperty(bound=false) public AdjustmentListener[] getAdjustmentListeners()

Возвращает массив всех добавленных в этот JScrollBar слушателей AdjustmentListener с помощью addAdjustmentListener().

Returns:: все добавленные слушатели AdjustmentListener или пустой массив, если слушатели не добавлены
Since:: 1.4

fireAdjustmentValueChanged

protected void fireAdjustmentValueChanged(int id, int type, int value)

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

Parameters:

id - целое число, указывающее тип события.

type - целое число, указывающее тип изменения.

value - текущее значение изменения

See Also:

setMinimumSize

public void setMinimumSize(Dimension minimumSize)

В отличие от большинства компонентов, JScrollBar вычисляет минимальный размер по одному из осей из предпочтительного размера и фиксированного минимального размера по другой оси. Таким образом, он переопределяет JComponent.setMinimumSize контракт, что последующие вызовы getMinimumSize вернут то же самое значение, что и задано в JComponent.setMinimumSize.

Overrides:

setMinimumSize in class JComponent

Parameters:

minimumSize - новый минимальный размер этого компонента

See Also:

setMaximumSize

public void setMaximumSize(Dimension maximumSize)

В отличие от большинства компонентов, JScrollBar вычисляет максимальный размер по одному из осей из предпочтительного размера и фиксированного максимального размера по другой оси. Таким образом, он переопределяет JComponent.setMaximumSize контракт, что последующие вызовы getMaximumSize вернут то же самое значение, что и задано в JComponent.setMaximumSize.

Overrides:

setMaximumSize in class JComponent

Parameters:

maximumSize - желаемый максимальный допустимый размер

See Also:

getMinimumSize

public Dimension getMinimumSize()

Возвращает минимальный размер для JScrollBar. Полоса прокрутки гибкая вдоль оси прокрутки и жёсткая вдоль другой оси. Как указано в setMinimumSize JScrollBar вычисляет минимальный размер из предпочтительного размера по одной оси и фиксированного минимального размера по другой.

Overrides:

getMinimumSize in class JComponent

Returns:

минимальный размер, как указано выше

See Also:

getMaximumSize

public Dimension getMaximumSize()

Возвращает максимальный размер для JScrollBar. Полоса прокрутки гибкая вдоль оси прокрутки и жёсткая вдоль другой оси. Как указано в setMaximumSize JScrollBar вычисляет максимальный размер из предпочтительного размера по одной оси и фиксированного максимального размера по другой.

Overrides:

getMaximumSize in class JComponent

Returns:

максимальный размер, как указано выше

See Also:

setEnabled

public void setEnabled(boolean x)

Включает компонент, позволяя изменять положение ползунка. При отключении положение ползунка изменить нельзя.

Overrides:

setEnabled in class JComponent

Parameters:

x - логическое значение, где true включает компонент, а false отключает

See Also:

paramString

protected String paramString()

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

Overrides:: paramString in class JComponent
Returns:: строковое представление этого JScrollBar.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext in interface Accessible
Overrides:: getAccessibleContext in class Component
Returns:: AccessibleJScrollBar, который служит AccessibleContext этого JScrollBar

© 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/javax/swing/JScrollBar.html