Spec-Zone.ru › OpenJDK 25

Класс JScrollBar

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
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
См. также:
  • JScrollPane

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

Модификатор и тип Класс Описание
protected class  JScrollBar.AccessibleJScrollBar
Этот класс реализует поддержку специальных возможностей для класса JScrollBar.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

HORIZONTAL, NO_ORIENTATION, VERTICAL

Поля, объявленные в интерфейсе 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()
Максимальное значение полосы прокрутки равно maximum - extent.
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()
Возвращает true, если бегунок полосы прокрутки перетаскивается.
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)
Устанавливает свойство максимального значения модели.
void setMaximumSize(Dimension maximumSize)
В отличие от большинства компонентов, JScrollBar определяет максимальный размер на основе предпочтительного размера по одной оси и фиксированного максимального размера по другой.
void setMinimum(int 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)
Устанавливает свойство размера области просмотра модели.
void updateUI()
Переопределяет JComponent.updateUI.

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

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

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

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

model

protected BoundedRangeModel model
Модель, представляющая минимальное и максимальное значения полосы прокрутки, размер области просмотра (также называемый «visibleAmount») и текущее значение.
См. также:
  • setModel(BoundedRangeModel)

orientation

protected int orientation
Ориентация этой полосы прокрутки.
См. также:
  • setOrientation(int)

unitIncrement

protected int unitIncrement
Хранит величину, на которую изменяется значение полосы прокрутки при запросе прокрутки вверх или вниз на одну единицу.
См. также:
  • setUnitIncrement(int)

blockIncrement

protected int blockIncrement
Хранит величину, на которую изменяется значение полосы прокрутки при запросе прокрутки вверх или вниз на один блок (обычно «страницу»).
См. также:
  • setBlockIncrement(int)

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

JScrollBar

public JScrollBar(int orientation, int value, int extent, int min, int max)
Создает полосу прокрутки с указанными ориентацией, значением, размером области просмотра, минимальным и максимальным значениями. «Размер области просмотра» — это размер видимой области. Он также называется «visible amount».

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

Параметры:
orientation — ориентация JScrollBar
value — int, задающий текущее значение
extent — int, задающий величину, на которую может «перепрыгнуть» значение
min — int, задающий минимальное значение
max — int, задающий максимальное значение
Исключения:
IllegalArgumentException — если ориентация не равна VERTICAL или HORIZONTAL
См. также:
  • setOrientation(int)
  • setValue(int)
  • setVisibleAmount(int)
  • setMinimum(int)
  • setMaximum(int)

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
См. также:
  • UIDefaults.getUI(JComponent)

getUI

public ScrollBarUI getUI()
Возвращает делегат, реализующий внешний вид и поведение этого компонента.
Переопределяет:
getUI в классе JComponent
Возвращает:
текущий пользовательский интерфейс полосы прокрутки.
См. также:
  • JComponent.setUI(ComponentUI)

updateUI

public void updateUI()
Переопределяет JComponent.updateUI.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса LookAndFeel для этого компонента.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "ScrollBarUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

getOrientation

public int getOrientation()
Возвращает ориентацию компонента (горизонтальную или вертикальную).
Определено в:
getOrientation в интерфейсе Adjustable
Возвращает:
VERTICAL или HORIZONTAL
См. также:
  • setOrientation(int)
  • Adjustable.getOrientation()

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
См. также:
  • getOrientation()

getModel

public BoundedRangeModel getModel()
Возвращает модель данных, управляющую четырьмя основными свойствами полосы прокрутки: минимальным и максимальным значениями, текущим значением и размером области просмотра.
Возвращает:
модель данных
См. также:
  • setModel(BoundedRangeModel)

setModel

@BeanProperty(expert=true, description="The scrollbar's BoundedRangeModel.") public void setModel(BoundedRangeModel newModel)
Задает модель, управляющую четырьмя основными свойствами полосы прокрутки: минимальным и максимальным значениями, текущим значением и размером области просмотра.
Параметры:
newModel — новая модель
См. также:
  • getModel()

getUnitIncrement

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

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

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

Параметры:
direction — равно -1 или 1 для прокрутки вверх или вниз соответственно
Возвращает:
значение свойства unitIncrement
См. также:
  • setUnitIncrement(int)
  • setValue(int)
  • Scrollable.getScrollableUnitIncrement(Rectangle, int, int)

setUnitIncrement

@BeanProperty(preferred=true, description="The scrollbar's unit increment.") public void setUnitIncrement(int unitIncrement)
Задает свойство unitIncrement.

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

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

Определено в:
setUnitIncrement в интерфейсе Adjustable
Параметры:
unitIncrement — приращение единицы
См. также:
  • getUnitIncrement(int)

getBlockIncrement

public int getBlockIncrement(int direction)
Возвращает величину изменения значения полосы прокрутки при запросе прокрутки вверх или вниз на один блок (обычно «страницу»). Обычно реализация ScrollBarUI вызывает этот метод, когда пользователь щелкает за пределами «бегунка» полосы прокрутки, чтобы прокрутить ее вверх или вниз на значительное расстояние. Подклассы могут переопределить этот метод для вычисления значения, например величины, необходимой для прокрутки на один абзац текстового документа.

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

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

Параметры:
direction — равно -1 или 1 для прокрутки вверх или вниз соответственно
Возвращает:
значение свойства blockIncrement
См. также:
  • setBlockIncrement(int)
  • setValue(int)
  • Scrollable.getScrollableBlockIncrement(Rectangle, int, int)

setBlockIncrement

@BeanProperty(preferred=true, description="The scrollbar's block increment.") public void setBlockIncrement(int blockIncrement)
Задает свойство blockIncrement.

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

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

Определено в:
setBlockIncrement в интерфейсе Adjustable
Параметры:
blockIncrement — приращение блока
См. также:
  • getBlockIncrement()

getUnitIncrement

public int getUnitIncrement()
Для обеспечения обратной совместимости с java.awt.Scrollbar.
Определено в:
getUnitIncrement в интерфейсе Adjustable
Возвращает:
приращение значения единицы для настраиваемого объекта
См. также:
  • Adjustable.getUnitIncrement()
  • getUnitIncrement(int)

getBlockIncrement

public int getBlockIncrement()
Для обеспечения обратной совместимости с java.awt.Scrollbar.
Определено в:
getBlockIncrement в интерфейсе Adjustable
Возвращает:
приращение значения блока для настраиваемого объекта
См. также:
  • Adjustable.getBlockIncrement()
  • getBlockIncrement(int)

getValue

public int getValue()
Возвращает значение полосы прокрутки.
Определено в:
getValue в интерфейсе Adjustable
Возвращает:
свойство value модели
См. также:
  • setValue(int)

setValue

@BeanProperty(bound=false, preferred=true, description="The scrollbar's current value.") public void setValue(int value)
Задает значение полосы прокрутки. Этот метод просто передает значение модели.
Определено в:
setValue в интерфейсе Adjustable
Параметры:
value — текущее значение в диапазоне от minimum до maximum - visibleAmount
См. также:
  • getValue()
  • BoundedRangeModel.setValue(int)

getVisibleAmount

public int getVisibleAmount()
Возвращает размер области просмотра полосы прокрутки, также называемый «visibleAmount». Во многих реализациях внешнего вида и поведения размер «бегунка» или «ползунка» полосы прокрутки пропорционален этому значению.
Определено в:
getVisibleAmount в интерфейсе Adjustable
Возвращает:
значение свойства extent модели
См. также:
  • setVisibleAmount(int)

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 — длина индикатора
См. также:
  • getVisibleAmount()
  • BoundedRangeModel.setExtent(int)

getMinimum

public int getMinimum()
Возвращает минимальное значение, поддерживаемое полосой прокрутки (обычно ноль).
Определено в:
getMinimum в интерфейсе Adjustable
Возвращает:
значение свойства minimum модели
См. также:
  • setMinimum(int)

setMinimum

@BeanProperty(bound=false, preferred=true, description="The scrollbar's minimum value.") public void setMinimum(int minimum)
Задает свойство minimum модели.
Определено в:
setMinimum в интерфейсе Adjustable
Параметры:
minimum — минимальное значение
См. также:
  • getMinimum()
  • BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()
Максимальное значение полосы прокрутки равно maximum - extent.
Определено в:
getMaximum в интерфейсе Adjustable
Возвращает:
значение свойства maximum модели
См. также:
  • setMaximum(int)

setMaximum

@BeanProperty(bound=false, preferred=true, description="The scrollbar's maximum value.") public void setMaximum(int maximum)
Задает свойство maximum модели. Обратите внимание, что значение полосы прокрутки можно установить только в maximum - extent.
Определено в:
setMaximum в интерфейсе Adjustable
Параметры:
maximum — максимальное значение
См. также:
  • getMaximum()
  • BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()
Возвращает true, если бегунок полосы прокрутки перетаскивается.
Возвращает:
значение свойства valueIsAdjusting модели
См. также:
  • setValueIsAdjusting(boolean)

setValueIsAdjusting

@BeanProperty(bound=false, expert=true, description="True if the scrollbar thumb is being dragged.") public void setValueIsAdjusting(boolean b)
Задает свойство valueIsAdjusting модели. Реализации внешнего вида и поведения полосы прокрутки должны устанавливать это свойство в true при начале перетаскивания бегунка и в false по завершении перетаскивания. Модель полосы прокрутки не будет генерировать события ChangeEvent, пока valueIsAdjusting равно true.
Параметры:
b — true, если предстоящие изменения свойства value являются частью последовательности
См. также:
  • getValueIsAdjusting()
  • BoundedRangeModel.setValueIsAdjusting(boolean)

setValues

public void setValues(int newValue, int newExtent, int newMin, int newMax)
Задает четыре свойства BoundedRangeModel, предварительно приводя аргументы к соответствию обычным ограничениям:
minimum ≤ value ≤ value+extent ≤ maximum
Параметры:
newValue — int, задающий текущее значение
newExtent — int, задающий величину, на которую может «перепрыгнуть» значение
newMin — int, задающий минимальное значение
newMax — int, задающий максимальное значение
См. также:
  • BoundedRangeModel.setRangeProperties(int, int, int, int, boolean)
  • setValue(int)
  • setVisibleAmount(int)
  • setMinimum(int)
  • setMaximum(int)

addAdjustmentListener

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

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

Определено в:
addAdjustmentListener в интерфейсе Adjustable
Параметры:
l — добавляемый AdjustmentLister
См. также:
  • removeAdjustmentListener(AdjustmentListener)
  • BoundedRangeModel.addChangeListener(ChangeListener)

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)
Удаляет слушатель событий AdjustmentEvent.
Определено в:
removeAdjustmentListener в интерфейсе Adjustable
Параметры:
l — удаляемый AdjustmentLister
См. также:
  • addAdjustmentListener(AdjustmentListener)

getAdjustmentListeners

@BeanProperty(bound=false) public AdjustmentListener[] getAdjustmentListeners()
Возвращает массив всех AdjustmentListeners, добавленных в этот JScrollBar с помощью addAdjustmentListener().
Возвращает:
все AdjustmentListeners, добавленные ранее, или пустой массив, если слушатели не добавлялись
Начиная с:
1.4

fireAdjustmentValueChanged

protected void fireAdjustmentValueChanged(int id, int type, int value)
Уведомляет слушателей об изменении модели полосы прокрутки.
Параметры:
id — целое число, указывающее тип события.
type — целое число, указывающее тип корректировки.
value — текущее значение корректировки
См. также:
  • addAdjustmentListener(AdjustmentListener)
  • EventListenerList

setMinimumSize

public void setMinimumSize(Dimension minimumSize)
В отличие от большинства компонентов, JScrollBar определяет минимальный размер на основе предпочтительного размера по одной оси и фиксированного минимального размера по другой. Таким образом, этот метод переопределяет контракт JComponent.setMinimumSize, согласно которому последующие вызовы getMinimumSize должны возвращать то же значение, которое было задано в JComponent.setMinimumSize.
Переопределяет:
setMinimumSize в классе JComponent
Параметры:
minimumSize — новый минимальный размер этого компонента
См. также:
  • JComponent.getMinimumSize()

setMaximumSize

public void setMaximumSize(Dimension maximumSize)
В отличие от большинства компонентов, JScrollBar определяет максимальный размер на основе предпочтительного размера по одной оси и фиксированного максимального размера по другой. Таким образом, этот метод переопределяет контракт JComponent.setMaximumSize, согласно которому последующие вызовы getMaximumSize должны возвращать то же значение, которое было задано в JComponent.setMaximumSize.
Переопределяет:
setMaximumSize в классе JComponent
Параметры:
maximumSize — желаемый максимально допустимый размер
См. также:
  • JComponent.getMaximumSize()

getMinimumSize

public Dimension getMinimumSize()
Возвращает минимальный размер JScrollBar. Полоса прокрутки может изменять размер вдоль оси прокрутки и имеет фиксированный размер вдоль другой оси. Согласно setMinimumSize JScrollBar определяет минимальный размер на основе предпочтительного размера по одной оси и фиксированного минимального размера по другой.
Переопределяет:
getMinimumSize в классе JComponent
Возвращает:
минимальный размер, как указано выше
См. также:
  • JComponent.setMinimumSize(Dimension)
  • ComponentUI

getMaximumSize

public Dimension getMaximumSize()
Возвращает максимальный размер JScrollBar. Полоса прокрутки может изменять размер вдоль оси прокрутки и имеет фиксированный размер вдоль другой оси. Согласно setMaximumSize JScrollBar определяет максимальный размер на основе предпочтительного размера по одной оси и фиксированного максимального размера по другой.
Переопределяет:
getMaximumSize в классе JComponent
Возвращает:
максимальный размер, как указано выше
См. также:
  • JComponent.setMaximumSize(Dimension)
  • ComponentUI

setEnabled

public void setEnabled(boolean x)
Включает компонент, позволяя изменять положение бегунка. Если компонент отключен, положение бегунка изменить нельзя.
Переопределяет:
setEnabled в классе JComponent
Параметры:
x — логическое значение: true включает компонент, false отключает его
См. также:
  • Component.isEnabled()
  • Component.isLightweight()

paramString

protected String paramString()
Возвращает строковое представление этого JScrollBar. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этого JScrollBar.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JScrollBar. Для JScrollBar объект AccessibleContext имеет тип AccessibleJScrollBar. При необходимости создается новый экземпляр AccessibleJScrollBar.
Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJScrollBar, выполняющий роль AccessibleContext для этого JScrollBar

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, обзор концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JScrollBar.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API