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

Вложенные классы/интерфейсы, объявленные в классе 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()

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

Dimension getMaximumSize()

Полоса прокрутки гибкая вдоль оси прокрутки и жёсткая вдоль другой оси.

int getMinimum()

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

Dimension getMinimumSize()

Полоса прокрутки гибкая вдоль оси прокрутки и жёсткая вдоль другой оси.

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)

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

void setMinimum​(int minimum)

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

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, 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, hide, 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

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

См. также:
setModel(javax.swing.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)

Создаёт полосу прокрутки с заданной ориентацией, значением, экстентом, минимумом и максимумом. "Extent" — это размер области просмотра. Также известен как "видимый объём".

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

Параметры:
orientation - ориентация JScrollBar
value - целое число, задающее текущее значение
extent - целое число, задающее величину "скачка" значения
min - целое число, задающее минимальное значение
max - целое число, задающее максимальное значение
Исключение:
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(javax.swing.JComponent)

getUI

public ScrollBarUI getUI()

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

Переопределяет:
getUI в классе JComponent
Возвращает:
текущий интерфейс пользователя полосы прокрутки.
См. также:
JComponent.setUI(javax.swing.plaf.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(javax.swing.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(javax.swing.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(java.awt.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(java.awt.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
Возвращает:
значение свойства модели
См. также:
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()

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

Возвращает:
значение свойства 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 при завершении перетаскивания. Модель полосы прокрутки не будет генерировать события ChangeEvents, пока значение 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 - целое число, задающее текущее значение
newExtent - целое число, задающее величину, на которую значение может «перескочить»
newMin - целое число, задающее минимальное значение
newMax - целое число, задающее максимальное значение
См. также:
BoundedRangeModel.setRangeProperties(int, int, int, int, boolean), setValue(int), setVisibleAmount(int), setMinimum(int), setMaximum(int)

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

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

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

Определено в:
addAdjustmentListener в интерфейсе Adjustable
Параметры:
l - добавляемый слушатель AdjustmentLister
См. также:
removeAdjustmentListener(java.awt.event.AdjustmentListener), BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

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

Определено в:
removeAdjustmentListener в интерфейсе Adjustable
Параметры:
l - слушатель AdjustmentLister для удаления
См. также:
addAdjustmentListener(java.awt.event.AdjustmentListener)

getAdjustmentListeners

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

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

Возвращает:
все добавленные слушатели AdjustmentListener или пустой массив, если слушатели не добавлены
С:
1.4

fireAdjustmentValueChanged

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

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

Параметры:
id - целое число, указывающее тип события.
type - целое число, указывающее тип корректировки.
value - текущее значение корректировки
См. также:
addAdjustmentListener(java.awt.event.AdjustmentListener), EventListenerList

getMinimumSize

public Dimension getMinimumSize()

Полоса прокрутки гибкая по оси прокрутки и жёсткая по другой оси.

Переопределяет:
getMinimumSize в классе JComponent
Возвращает:
значение свойства minimumSize
См. также:
JComponent.setMinimumSize(java.awt.Dimension), ComponentUI

getMaximumSize

public Dimension getMaximumSize()

Полоса прокрутки гибкая по оси прокрутки и жёсткая по другой оси.

Переопределяет:
getMaximumSize в классе JComponent
Возвращает:
значение свойства maximumSize
См. также:
JComponent.setMaximumSize(java.awt.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

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/JScrollBar.html

Spec-Zone .ru
спецификации, руководства, описания, API