Класс 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 | Этот класс реализует поддержку доступности для класса |
Вложенные классы/интерфейсы, объявленные в классе 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() | Возвращает массив всех |
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() | Переопределяет |
Методы, объявленные в классе 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&FScrollBarUI - С версии:
- 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