Класс 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
Обычно, когда меняется положение ползунка в полосе прокрутки, соответствующее изменение вносится в положение 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 |
Модель, представляющая минимальное, максимальное, текущее значение и протяжённость (также "видимая величина") ползунка. |
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 |
Создаёт ползунок с заданной ориентацией и следующими начальными значениями: |
JScrollBar |
Создаёт ползунок с заданной ориентацией, значением, протяжённостью, минимумом и максимумом. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addAdjustmentListener |
Добавляет слушателя AdjustmentListener. |
protected void |
fireAdjustmentValueChanged |
Уведомляет слушателей о том, что модель ползунка изменилась. |
AccessibleContext |
getAccessibleContext() |
Возвращает AccessibleContext, связанный с данным JScrollBar. |
AdjustmentListener[] |
getAdjustmentListeners() |
Возвращает массив всех AdjustmentListener, добавленных к этому JScrollBar с addAdjustmentListener(). |
int |
getBlockIncrement() |
Для обратной совместимости с java.awt.Scrollbar. |
int |
getBlockIncrement |
Возвращает величину изменения значения ползунка при запросе блока (обычно "страницы") вверх/вниз. |
int |
getMaximum() |
Максимальное значение ползунка равно максимальному - протяжённость. |
Dimension |
getMaximumSize() |
Ползунок гибкий вдоль оси прокрутки и жёсткий вдоль другой оси. |
int |
getMinimum() |
Возвращает минимальное значение, поддерживаемое ползунком (обычно ноль). |
Dimension |
getMinimumSize() |
Ползунок гибкий вдоль оси прокрутки и жёсткий вдоль другой оси. |
BoundedRangeModel |
getModel() |
Возвращает модель данных, которая обрабатывает четыре фундаментальных свойства ползунка: минимум, максимум, значение, протяжённость. |
int |
getOrientation() |
Возвращает ориентацию компонента (горизонтальная или вертикальная). |
ScrollBarUI |
getUI() |
Возвращает делегата, который реализует вид и ощущения для этого компонента. |
String |
getUIClassID() |
Возвращает имя класса LookAndFeel для этого компонента. |
int |
getUnitIncrement() |
Для обратной совместимости с java.awt.Scrollbar. |
int |
getUnitIncrement |
Возвращает величину изменения значения ползунка при запросе единицы вверх/вниз. |
int |
getValue() |
Возвращает значение ползунка. |
boolean |
getValueIsAdjusting() |
Истина, если ползунок перемещается. |
int |
getVisibleAmount() |
Возвращает протяжённость ползунка, также известную как "видимая величина". |
protected String |
paramString() |
Возвращает строковое представление данного JScrollBar. |
void |
removeAdjustmentListener |
Удаляет слушателя AdjustmentEvent. |
void |
setBlockIncrement |
Устанавливает свойство blockIncrement. |
void |
setEnabled |
Включает компонент, чтобы можно было изменить положение ползунка. |
void |
setMaximum |
Устанавливает свойство maximum модели. |
void |
setMinimum |
Устанавливает свойство minimum модели. |
void |
setModel |
Устанавливает модель, которая обрабатывает четыре фундаментальных свойства ползунка: минимум, максимум, значение, протяжённость. |
void |
setOrientation |
Устанавливает ориентацию ползунка на VERTICAL или HORIZONTAL. |
void |
setUI |
Устанавливает объект L&F, который отрисовывает этот компонент. |
void |
setUnitIncrement |
Устанавливает свойство unitIncrement. |
void |
setValue |
Устанавливает значение ползунка. |
void |
setValueIsAdjusting |
Устанавливает свойство valueIsAdjusting модели. |
void |
setValues |
Устанавливает четыре свойства BoundedRangeModel после принудительного соблюдения обычных ограничений: |
void |
setVisibleAmount |
Устанавливает свойство 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, setMaximumSize, setMinimumSize, 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
Подробное описание полей
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)
- Параметры:
-
ui- объект L&FScrollBarUI - С:
- 1.4
- См. также:
getUI
public ScrollBarUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- текущий UI полосы прокрутки.
- См. также:
updateUI
public void updateUI()
JComponent.updateUI.- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
- Переопределяет:
-
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) - Параметры:
-
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)
Компонент JScrollPane создает полосы прокрутки (по умолчанию), которые переопределяют этот метод и делегируют вычисление Scrollable-вьюпорту, если он есть. Интерфейс Scrollable предоставляет более специализированную версию этого метода.
Некоторые реализации виджетов, обеспечивающие настраиваемое поведение прокрутки, игнорируют это свойство.
- Параметры:
-
direction- -1 или 1 для запросов вверх/вниз соответственно - Возвращает:
- значение свойства unitIncrement
- См. также:
setUnitIncrement
@BeanProperty(preferred=true, description="The scrollbar\'s unit increment.") public void setUnitIncrement(int unitIncrement)
Если аргумент равен Integer.MIN_VALUE, то большинство реализаций виджетов не будут обеспечивать прокрутку вправо/вниз.
Некоторые реализации виджетов, обеспечивающие настраиваемое поведение прокрутки, игнорируют это свойство.
- Определено в:
-
setUnitIncrementв интерфейсеAdjustable - Параметры:
-
unitIncrement- шаг изменения - См. также:
getBlockIncrement
public int getBlockIncrement(int direction)
Компонент JScrollPane создает полосы прокрутки (по умолчанию), которые переопределяют этот метод и делегируют вычисление Scrollable-вьюпорту, если он есть. Интерфейс Scrollable предоставляет более специализированную версию этого метода.
Некоторые реализации виджетов, обеспечивающие настраиваемое поведение прокрутки, игнорируют это свойство.
- Параметры:
-
direction- -1 или 1 для запросов вверх/вниз соответственно - Возвращает:
- значение свойства blockIncrement
- См. также:
setBlockIncrement
@BeanProperty(preferred=true, description="The scrollbar\'s block increment.") public void setBlockIncrement(int blockIncrement)
Обратите внимание, что если аргумент равен значению Integer.MIN_VALUE, то большинство реализаций внешнего вида не будут обеспечивать прокрутку вправо/вниз.
Некоторые реализации внешнего вида, обеспечивающие настраиваемое поведение прокрутки, игнорируют это свойство.
- Specified by:
-
setBlockIncrementв интерфейсеAdjustable - Parameters:
-
blockIncrement- приращение блока - See Also:
getUnitIncrement
public int getUnitIncrement()
- Specified by:
-
getUnitIncrementв интерфейсеAdjustable - Returns:
- приращение единицы значения для настраиваемого объекта
- See Also:
getBlockIncrement
public int getBlockIncrement()
- Specified by:
-
getBlockIncrementв интерфейсеAdjustable - Returns:
- приращение блока значения для настраиваемого объекта
- See Also:
getValue
public int getValue()
- Specified by:
-
getValueв интерфейсеAdjustable - Returns:
- свойство значения модели
- See Also:
setValue
@BeanProperty(bound=false, preferred=true, description="The scrollbar\'s current value.") public void setValue(int value)
- Specified by:
-
setValueв интерфейсеAdjustable - Parameters:
-
value- текущее значение, междуminimumиmaximum-visibleAmount - See Also:
getVisibleAmount
public int getVisibleAmount()
- Specified by:
-
getVisibleAmountв интерфейсеAdjustable - Returns:
- значение свойства extent модели
- See Also:
setVisibleAmount
@BeanProperty(bound=false, preferred=true, description="The amount of the view that is currently visible.") public void setVisibleAmount(int extent)
- Specified by:
-
setVisibleAmountв интерфейсеAdjustable - Parameters:
-
extent- длина индикатора - See Also:
getMinimum
public int getMinimum()
- Specified by:
-
getMinimumв интерфейсеAdjustable - Returns:
- значение свойства minimum модели
- See Also:
setMinimum
@BeanProperty(bound=false, preferred=true, description="The scrollbar\'s minimum value.") public void setMinimum(int minimum)
- Specified by:
-
setMinimumв интерфейсеAdjustable - Parameters:
-
minimum- минимальное значение - See Also:
getMaximum
public int getMaximum()
- Specified by:
-
getMaximumв интерфейсеAdjustable - Returns:
- значение свойства maximum модели
- See Also:
setMaximum
@BeanProperty(bound=false, preferred=true, description="The scrollbar\'s maximum value.") public void setMaximum(int maximum)
- Specified by:
-
setMaximumв интерфейсеAdjustable - Parameters:
-
maximum- максимальное значение - See Also:
getValueIsAdjusting
public boolean getValueIsAdjusting()
- Returns:
- значение свойства valueIsAdjusting модели
- See Also:
setValueIsAdjusting
@BeanProperty(bound=false, expert=true, description="True if the scrollbar thumb is being dragged.") public void setValueIsAdjusting(boolean b)
- Parameters:
-
b-true, если предстоящие изменения свойства value являются частью серии - See Also:
setValues
public void setValues(int newValue, int newExtent, int newMin, int newMax)
minimum ≤ value ≤ value+extent ≤ maximum
- Parameters:
-
newValue- целое число, представляющее текущее значение -
newExtent- целое число, определяющее величину "скачка" значения -
newMin- целое число, определяющее минимальное значение -
newMax- целое число, определяющее максимальное значение - See Also:
addAdjustmentListener
public void addAdjustmentListener(AdjustmentListener l)
Обратите внимание, что свойство типа AdjustmentEvents всегда будет иметь значение по умолчанию AdjustmentEvent.TRACK, потому что все изменения значения BoundedRangeModels считаются эквивалентными. Чтобы изменить значение BoundedRangeModel, достаточно установить его свойство value, т. е. model.setValue(123). Информация об источнике изменения, например, это уменьшение блока, не предоставляется. Мы не пытаемся сгенерировать источник изменения здесь.
- Specified by:
-
addAdjustmentListenerв интерфейсеAdjustable - Parameters:
-
l- добавляемый AdjustmentLister - See Also:
removeAdjustmentListener
public void removeAdjustmentListener(AdjustmentListener l)
- Specified by:
-
removeAdjustmentListenerв интерфейсеAdjustable - Parameters:
-
l- удаляемый AdjustmentLister - See Also:
getAdjustmentListeners
@BeanProperty(bound=false) public AdjustmentListener[] getAdjustmentListeners()
AdjustmentListener, добавленных в этот JScrollBar с помощью addAdjustmentListener().- Returns:
- все добавленные
AdjustmentListenerили пустой массив, если обработчики не добавлены - Since:
- 1.4
fireAdjustmentValueChanged
protected void fireAdjustmentValueChanged(int id, int type, int value)
- Параметры:
-
id- целое число, указывающее тип события. -
type- целое число, указывающее тип изменения. -
value- текущее значение изменения - См. также:
getMinimumSize
public Dimension getMinimumSize()
- Переопределяет:
-
getMinimumSizeв классеJComponent - Возвращает:
- значение свойства
minimumSize - См. также:
getMaximumSize
public Dimension getMaximumSize()
- Переопределяет:
-
getMaximumSizeв классеJComponent - Возвращает:
- значение свойства
maximumSize - См. также:
setEnabled
public void setEnabled(boolean x)
- Переопределяет:
-
setEnabledв классеJComponent - Параметры:
-
x- логическое значение, где true включает компонент, а false отключает его - См. также:
paramString
protected String paramString()
null.- Переопределяет:
-
paramStringв классеJComponent - Возвращает:
- строковое представление JScrollBar.
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleJScrollBar, который служит AccessibleContext этого JScrollBar
© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/JScrollBar.html