Класс JSlider

Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants 
@JavaBean(defaultProperty="UI",
          description="A component that supports selecting a integer value from a range.")
public class JSlider
extends JComponent
implements SwingConstants, Accessible

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

Ползунок может отображать как основные метки, так и дополнительные метки между основными. Количество значений между метками контролируется setMajorTickSpacing и setMinorTickSpacing. Отрисовка меток контролируется setPaintTicks.

Ползунки также могут отображать текстовые метки через равные интервалы (или в произвольных местах) по всей длине полосы ползунка. Отрисовка меток контролируется setLabelTable и setPaintLabels.

Дополнительную информацию и примеры см. на странице Как использовать ползунки в Java Tutorial.

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

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

С:
1.2
См. также:
Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  JSlider.AccessibleJSlider

Этот класс реализует поддержку доступности для класса JSlider.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Поля

Модификатор и тип Поле Описание
protected ChangeEvent changeEvent

Для каждого экземпляра ползунка требуется только один ChangeEvent, так как состояние события (только для чтения) — это свойство источника.
protected ChangeListener changeListener

Обработчик событий изменения (без суффикса) — это слушатель, который мы добавляем к модели ползунка.
protected int majorTickSpacing

Количество значений между основными метками — более крупными метками, которые разбивают дополнительные метки.
protected int minorTickSpacing

Количество значений между дополнительными метками — более мелкими метками, которые появляются между основными метками.
protected int orientation

Ориентация ползунка — горизонтальная или вертикальная. По умолчанию горизонтальная.
protected BoundedRangeModel sliderModel

Модель данных, которая обрабатывает максимальное, минимальное и текущее значения для ползунка.
protected boolean snapToTicks

Если true, ползунок (и представляемое им значение) будет настроен на ближайшую метку рядом с местом, где пользователь расположил ползунок.

Поля, объявленные в классе 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.image.ImageObserver

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

Поля, объявленные в интерфейсе javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

Конструктор Описание
JSlider()

Создаёт горизонтальный ползунок с диапазоном от 0 до 100 и начальным значением 50.
JSlider​(int orientation)

Создаёт ползунок с указанной ориентацией, диапазоном от 0 до 100 и начальным значением 50.

JSlider​(int min, int max)

Создаёт горизонтальный ползунок с заданными минимальным и максимальным значениями, а начальное значение равно среднему арифметическому минимального и максимального значений.
JSlider​(int min, int max, int value)

Создаёт горизонтальный ползунок с заданными минимальным, максимальным и начальным значениями.
JSlider​(int orientation, int min, int max, int value)

Создаёт ползунок с указанной ориентацией и заданными минимальным, максимальным и начальными значениями.
JSlider​(BoundedRangeModel brm)

Создаёт горизонтальный ползунок с использованием указанной модели BoundedRangeModel.

Методы

Модификатор и тип Метод Описание
void addChangeListener​(ChangeListener l)

Добавляет ChangeListener к ползунку.
protected ChangeListener createChangeListener()

Подклассы, которые хотят обрабатывать ChangeEvent от модели по-другому, могут переопределить этот метод, чтобы вернуть экземпляр реализации пользовательского ChangeListener.
Hashtable<Integer,​JComponent> createStandardLabels​(int increment)

Создаёт Hashtable числовых текстовых меток, начиная с минимального значения ползунка и используя указанный шаг.
Hashtable<Integer,​JComponent> createStandardLabels​(int increment, int start)

Создаёт Hashtable числовых текстовых меток, начиная с указанной начальной точки и используя указанный шаг.
protected void fireStateChanged()

Отправляет ChangeEvent, чьим источником является этот JSlider, всем ChangeListener , которые зарегистрировали интерес к ChangeEvent.
AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JSlider.
ChangeListener[] getChangeListeners()

Возвращает массив всех ChangeListener , добавленных к этому JSlider с помощью addChangeListener().
int getExtent()

Возвращает "объём" из BoundedRangeModel.
boolean getInverted()

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

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

Этот метод возвращает интервал основных рисок.
int getMaximum()

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

Возвращает минимальное значение, поддерживаемое ползунком, из BoundedRangeModel.
int getMinorTickSpacing()

Этот метод возвращает интервал второстепенных рисок.
BoundedRangeModel getModel()

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

Возвращает вертикальную или горизонтальную ориентацию данного ползунка.
boolean getPaintLabels()

Указывает, нужно ли рисовать метки.
boolean getPaintTicks()

Указывает, нужно ли рисовать риски.
boolean getPaintTrack()

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

Возвращает true, если рукоятка (и представляемое ею значение данных) находит ближайшую риску рядом с тем местом, где пользователь расположил рукоятку.
SliderUI getUI()

Получает UI-объект, который реализует L&F для данного компонента.
String getUIClassID()

Возвращает имя класса L&F, который отображает этот компонент.
int getValue()

Возвращает текущее значение ползунка из BoundedRangeModel.
boolean getValueIsAdjusting()

Возвращает свойство valueIsAdjusting из модели.
boolean imageUpdate​(Image img, int infoflags, int x, int y, int w, int h)

Перерисовывает компонент, когда изображение изменилось.
protected String paramString()

Возвращает строковое представление этого JSlider.
void removeChangeListener​(ChangeListener l)

Удаляет ChangeListener из ползунка.
void setExtent​(int extent)

Устанавливает размер диапазона, "покрываемого" рукояткой.
void setFont​(Font font)

Устанавливает шрифт для этого компонента.
void setInverted​(boolean b)

Установите значение true, чтобы инвертировать диапазон значений, отображаемый для ползунка, и false, чтобы отобразить диапазон значений в нормальном порядке.
void setLabelTable​(Dictionary labels)

Используется для указания метки, которая будет нарисована для любого заданного значения.
void setMajorTickSpacing​(int n)

Этот метод устанавливает интервал основных рисок.
void setMaximum​(int maximum)

Устанавливает максимальное значение ползунка в maximum.
void setMinimum​(int minimum)

Устанавливает минимальное значение ползунка в minimum.
void setMinorTickSpacing​(int n)

Этот метод устанавливает интервал второстепенных рисок.
void setModel​(BoundedRangeModel newModel)

Устанавливает BoundedRangeModel , который обрабатывает три фундаментальные свойства ползунка: минимум, максимум, значение.
void setOrientation​(int orientation)

Установите ориентацию ползунка на SwingConstants.VERTICAL или SwingConstants.HORIZONTAL.
void setPaintLabels​(boolean b)

Определяет, будут ли на ползунке отображаться метки.
void setPaintTicks​(boolean b)

Определяет, будут ли на ползунке отображаться риски.
void setPaintTrack​(boolean b)

Определяет, будет ли на ползунке отображаться дорожка.
void setSnapToTicks​(boolean b)

Указание значения true приводит к тому, что рукоятка (и представляемое ею значение данных) будет отображаться на ближайшей риске рядом с тем местом, где пользователь расположил рукоятку.
void setUI​(SliderUI ui)

Устанавливает UI-объект, реализующий L&F для этого компонента.
void setValue​(int n)

Устанавливает текущее значение ползунка в n.
void setValueIsAdjusting​(boolean b)

Устанавливает свойство valueIsAdjusting модели.
protected void updateLabelUIs()

Обновляет UI-элементы для меток в таблице меток, вызывая updateUI для каждой метки.
void updateUI()

Сбрасывает свойство UI до значения из текущего внешнего вида.

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

Поля

sliderModel

protected BoundedRangeModel sliderModel

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

majorTickSpacing

protected int majorTickSpacing

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

minorTickSpacing

protected int minorTickSpacing

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

См. также:
setMinorTickSpacing(int)

snapToTicks

protected boolean snapToTicks

Если true, рычаг (и представляемое им значение данных) устанавливается на ближайшую отметку рядом с тем местом, где пользователь расположил рычаг. По умолчанию значение false.

См. также:
setSnapToTicks(boolean)

orientation

protected int orientation

Горизонтальный или вертикальный ползунок. По умолчанию горизонтальный.

См. также:
setOrientation(int)

changeListener

protected ChangeListener changeListener

changeListener (без суффикса) — это слушатель, который мы добавляем к модели ползунка. Этот слушатель инициализирован значением, возвращаемым createChangeListener, которое по умолчанию просто пересылает события слушателям ChangeListener (если таковые имеются), добавленным непосредственно в ползунок.

См. также:
addChangeListener(javax.swing.event.ChangeListener), createChangeListener()

changeEvent

protected transient ChangeEvent changeEvent

Для каждого экземпляра ползунка требуется только один ChangeEvent, так как единственное (только для чтения) состояние события — это свойство источника. Источник событий, генерируемых здесь, всегда «this». Событие создаётся лениво при первом запуске уведомления об событии.

См. также:
fireStateChanged()

Конструкторы

JSlider

public JSlider()

Создаёт горизонтальный ползунок с диапазоном от 0 до 100 и начальным значением 50.

JSlider

public JSlider(int orientation)

Создаёт ползунок с указанной ориентацией с диапазоном 0 до 100 и начальным значением 50. Ориентация может быть SwingConstants.VERTICAL или SwingConstants.HORIZONTAL.

Параметры:
orientation — ориентация ползунка
Исключения:
IllegalArgumentException — если ориентация не VERTICAL, HORIZONTAL
См. также:
setOrientation(int)

JSlider

public JSlider(int min,
               int max)

Создаёт горизонтальный ползунок с указанными минимальным и максимальным значениями, при этом начальное значение равно среднему арифметическому минимального и максимального значений.

Класс BoundedRangeModel, который хранит данные ползунка, обрабатывает любые проблемы, которые могут возникнуть при неправильной установке минимального и максимального значений ползунка. Подробнее см. документацию BoundedRangeModel.

Параметры:
min — минимальное значение ползунка
max — максимальное значение ползунка
См. также:
BoundedRangeModel, setMinimum(int), setMaximum(int)

JSlider

public JSlider(int min,
               int max,
               int value)

Создаёт горизонтальный ползунок с указанными минимальным, максимальным и начальным значениями.

Класс BoundedRangeModel, который хранит данные ползунка, обрабатывает любые проблемы, которые могут возникнуть при неправильной установке минимального, начального и максимального значений ползунка. Подробнее см. документацию BoundedRangeModel.

Параметры:
min — минимальное значение ползунка
max — максимальное значение ползунка
value — начальное значение ползунка
См. также:
BoundedRangeModel, setMinimum(int), setMaximum(int), setValue(int)

JSlider

public JSlider(int orientation,
               int min,
               int max,
               int value)

Создаёт ползунок с указанной ориентацией и указанными минимальным, максимальным и начальным значениями. Ориентация может быть SwingConstants.VERTICAL или SwingConstants.HORIZONTAL.

Класс BoundedRangeModel, который хранит данные ползунка, обрабатывает любые проблемы, которые могут возникнуть при неправильной установке минимального, начального и максимального значений ползунка. Подробнее см. документацию BoundedRangeModel.

Параметры:
orientation — ориентация ползунка
min — минимальное значение ползунка
max — максимальное значение ползунка
value — начальное значение ползунка
Исключения:
IllegalArgumentException — если ориентация не VERTICAL, HORIZONTAL
См. также:
BoundedRangeModel, setOrientation(int), setMinimum(int), setMaximum(int), setValue(int)

JSlider

public JSlider(BoundedRangeModel brm)

Создаёт горизонтальный ползунок с использованием указанной BoundedRangeModel.

Параметры:
brm — BoundedRangeModel для ползунка

Методы

getUI

public SliderUI getUI()

Получает объект UI, реализующий L&F для этого компонента.

Переопределяет:
getUI в классе JComponent
Возвращает:
объект SliderUI, реализующий L&F для ползунка

setUI

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

Устанавливает объект UI, реализующий L&F для этого компонента.

Параметры:
ui - объект L&F SliderUI
См. также:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Сбрасывает свойство UI на значение из текущего стиля отображения.

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

getUIClassID

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

Возвращает имя класса L&F, который отрисовывает этот компонент.

Переопределяет:
getUIClassID в классе JComponent
Возвращает:
"SliderUI"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

createChangeListener

protected ChangeListener createChangeListener()

Подклассы, которые хотят обработать ChangeEvent от модели по-другому, могут переопределить этот метод для возврата экземпляра собственной реализации ChangeListener. По умолчанию ChangeListener просто вызывает метод fireStateChanged, чтобы передать ChangeEvent слушателям, которые были добавлены непосредственно к ползунку.

Возвращает:
экземпляр нового ChangeListener
См. также:
changeListener, fireStateChanged(), ChangeListener, BoundedRangeModel

addChangeListener

public void addChangeListener(ChangeListener l)

Добавляет ChangeListener к ползунку.

Параметры:
l - добавляемый ChangeListener
См. также:
fireStateChanged(), removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener из ползунка.

Параметры:
l - удаляемый ChangeListener
См. также:
fireStateChanged(), addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

@BeanProperty(bound=false)
public ChangeListener[] getChangeListeners()

Возвращает массив всех ChangeListener добавленных к этому JSlider с помощью addChangeListener().

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

fireStateChanged

protected void fireStateChanged()

Отправляет ChangeEvent, чьим источником является этот JSlider, всем ChangeListener , которые зарегистрировали интерес к ChangeEvent . Этот метод вызывается каждый раз, когда от модели поступает ChangeEvent .

Экземпляр события создается при необходимости и сохраняется в changeEvent.

См. также:
addChangeListener(javax.swing.event.ChangeListener), EventListenerList

getModel

public BoundedRangeModel getModel()

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

Возвращает:
модель данных для этого компонента
См. также:
setModel(javax.swing.BoundedRangeModel), BoundedRangeModel

setModel

@BeanProperty(description="The sliders BoundedRangeModel.")
public void setModel(BoundedRangeModel newModel)

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

Попытка передать null модель в этот метод приведет к неопределенному поведению и, скорее всего, к исключениям.

Параметры:
newModel - новая, non-null BoundedRangeModel модель
См. также:
getModel(), BoundedRangeModel

getValue

public int getValue()

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

Возвращает:
текущее значение ползунка
См. также:
setValue(int), BoundedRangeModel.getValue()

setValue

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

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

Модель данных (экземпляр BoundedRangeModel) обрабатывает любые математические проблемы, возникающие при назначении неправильных значений. Подробности см. в документации BoundedRangeModel .

Если новое значение отличается от предыдущего, все слушатели изменений уведомляются.

Параметры:
n - новое значение
См. также:
getValue(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setValue(int)

getMinimum

public int getMinimum()

Возвращает минимальное значение, поддерживаемое ползунком, из BoundedRangeModel.

Возвращает:
значение свойства минимума модели
См. также:
setMinimum(int), BoundedRangeModel.getMinimum()

setMinimum

@BeanProperty(preferred=true,
              description="The sliders minimum value.")
public void setMinimum(int minimum)

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

Модель данных (экземпляр BoundedRangeModel) обрабатывает любые математические проблемы, возникающие при назначении неправильных значений. Подробности см. в документации BoundedRangeModel.

Если новое минимальное значение отличается от предыдущего, все слушатели изменений уведомляются.

Параметры:
minimum - новый минимум
См. также:
getMinimum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()

Возвращает максимальное значение, поддерживаемое ползунком, из BoundedRangeModel.

Возвращает:
значение свойства максимума модели
См. также:
setMaximum(int), BoundedRangeModel.getMaximum()

setMaximum

@BeanProperty(preferred=true,
              description="The sliders maximum value.")
public void setMaximum(int maximum)

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

Модель данных (экземпляр BoundedRangeModel) обрабатывает любые математические проблемы, возникающие при назначении неправильных значений. Подробности см. в документации BoundedRangeModel.

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

Параметры:
maximum - новый максимум
См. также:
getMaximum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

Возвращает свойство valueIsAdjusting из модели. Подробности о том, как это используется, см. в документации setValueIsAdjusting.

Возвращает:
значение свойства valueIsAdjusting модели
См. также:
setValueIsAdjusting(boolean)

setValueIsAdjusting

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

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

Параметры:
b - новое значение свойства valueIsAdjusting
См. также:
getValueIsAdjusting(), BoundedRangeModel.setValueIsAdjusting(boolean)

getExtent

public int getExtent()

Возвращает "диапазон" из BoundedRangeModel. Он представляет диапазон значений, "покрытых" ручкой.

Возвращает:
целое число, представляющее диапазон
См. также:
setExtent(int), BoundedRangeModel.getExtent()

setExtent

@BeanProperty(bound=false,
              expert=true,
              description="Size of the range covered by the knob.")
public void setExtent(int extent)

Устанавливает размер диапазона, "покрытого" ручкой. Большинство реализаций стиля отображения изменят значение на это количество, если пользователь щелкнет по сторонам ручки. Этот метод просто передает новое значение диапазона модели.

Модель данных (экземпляр BoundedRangeModel ) обрабатывает любые математические проблемы, возникающие при назначении неправильных значений. Подробности см. в документации BoundedRangeModel.

Если новое значение диапазона отличается от предыдущего, все слушатели изменений уведомляются.

Параметры:
extent - новый диапазон
См. также:
getExtent(), BoundedRangeModel.setExtent(int)

getOrientation

public int getOrientation()

Возвращает вертикальную или горизонтальную ориентацию ползунка.

Возвращает:
SwingConstants.VERTICAL или SwingConstants.HORIZONTAL
См. также:
setOrientation(int)

setOrientation

@BeanProperty(preferred=true,
              visualUpdate=true,
              enumerationValues={"JSlider.VERTICAL","JSlider.HORIZONTAL"},
              description="Set the scrollbars orientation to either VERTICAL or HORIZONTAL.")
public void setOrientation(int orientation)

Установите ориентацию ползунка на SwingConstants.VERTICAL или SwingConstants.HORIZONTAL.

Параметры:
orientation - HORIZONTAL или VERTICAL
Исключения:
IllegalArgumentException - если ориентация не соответствует VERTICAL, HORIZONTAL
См. также:
getOrientation()

setFont

public void setFont(Font font)

Устанавливает шрифт для этого компонента.

Переопределяет:
setFont в классе JComponent
Параметры:
font - желаемый Font для этого компонента
С тех пор:
1.6
См. также:
Component.getFont()

imageUpdate

public boolean imageUpdate(Image img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)

Перерисовывает компонент при изменении изображения. Этот imageUpdate метод компонента ImageObserver вызывается, когда становится доступна дополнительная информация об изображении, которое ранее запрашивалось с помощью асинхронной операции, например, метода drawImage из Graphics. См. определение imageUpdate для получения дополнительной информации об этом методе и его аргументах.

Метод imageUpdate из Component поэтапно отрисовывает изображение на компоненте по мере поступления новых битов изображения.

Если системная переменная awt.image.incrementaldraw отсутствует или имеет значение true, изображение отрисовывается поэтапно. В противном случае изображение отрисовывается только после полной загрузки.

Если поэтапная отрисовка включена, значение системной переменной awt.image.redrawrate интерпретируется как целое число, определяющее максимальную частоту перерисовки в миллисекундах. Если системная переменная отсутствует или не может быть интерпретирована как целое число, частота перерисовки составляет 100 мс.

Интерпретация аргументов x, y, width и height зависит от значения аргумента infoflags.

Определено в:
imageUpdate в интерфейсе ImageObserver
Переопределяет:
imageUpdate в классе Component
Параметры:
img - наблюдаемое изображение
infoflags - см. imageUpdate для получения дополнительной информации
x - координата x
y - координата y
w - ширина
h - высота
Возвращает:
false если infoflags указывают, что изображение полностью загружено; true в противном случае.
С тех пор:
1.7
См. также:
ImageObserver, Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver), ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

getLabelTable

public Dictionary getLabelTable()

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

Возвращает:
словарь, содержащий метки и места их отрисовки

setLabelTable

@BeanProperty(hidden=true,
              visualUpdate=true,
              description="Specifies what labels will be drawn for any given value.")
public void setLabelTable(Dictionary labels)

Используется для указания метки, которая будет отрисована для каждого значения. Пара ключей-значений имеют следующий формат: { Integer value, java.swing.JComponent label }.

Простой способ сгенерировать стандартную таблицу меток значений - использовать метод createStandardLabels.

После установки меток этот метод вызывает updateLabelUIs(). Обратите внимание, что метки отрисовываются только если свойство paintLabels имеет значение true.

Параметры:
labels - новый Dictionary меток или null для удаления всех меток
См. также:
createStandardLabels(int), getLabelTable(), setPaintLabels(boolean)

updateLabelUIs

protected void updateLabelUIs()

Обновляет пользовательские интерфейсы меток в таблице меток, вызывая updateUI для каждой метки. Обновление выполняется на основе текущей темы оформления. Метки также устанавливаются в их предпочтительный размер.

См. также:
setLabelTable(java.util.Dictionary), JComponent.updateUI()

createStandardLabels

public Hashtable<Integer,JComponent> createStandardLabels​(int increment)

Создает Hashtable числовых меток текста, начиная с минимального значения ползунка и используя указанный шаг. Например, если вызвать createStandardLabels( 10 ), а минимальное значение ползунка - ноль, то метки будут созданы для значений 0, 10, 20, 30 и т. д.

Чтобы метки отображались на ползунке, возвращаемый Hashtable должен быть передан в setLabelTable, а setPaintLabels должно быть установлено в true.

Дополнительные сведения о структуре возвращаемого Hashtable см. в документации setLabelTable.

Параметры:
increment - расстояние между метками в сгенерированной хэш-таблице
Возвращает:
новый Hashtable меток
Исключения:
IllegalArgumentException - если increment меньше или равно нулю
См. также:
setLabelTable(java.util.Dictionary), setPaintLabels(boolean)

createStandardLabels

public Hashtable<Integer,JComponent> createStandardLabels​(int increment,
                                                                int start)

Создаёт Hashtable числовых меток текста, начиная с заданной начальной точки и используя заданный шаг. Например, если вызвать createStandardLabels( 10, 2 ), то метки будут созданы для значений 2, 12, 22, 32 и т. д.

Чтобы метки отображались на ползунке, возвращаемый Hashtable должен быть передан в setLabelTable, а setPaintLabels должно быть установлено в true.

Дополнительные сведения о структуре возвращаемого Hashtable см. в документации setLabelTable.

Параметры:
increment - расстояние между метками в сгенерированной хэш-таблице
start - значение, с которого будут начинаться метки
Возвращает:
новый Hashtable меток
Исключения:
IllegalArgumentException - если start выходит за пределы допустимого диапазона или если increment меньше или равно нулю
См. также:
setLabelTable(java.util.Dictionary), setPaintLabels(boolean)

getInverted

public boolean getInverted()

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

Возвращает:
true, если значения ползунка отображаются в обратном порядке по сравнению с их нормальным порядком
См. также:
setInverted(boolean)

setInverted

@BeanProperty(visualUpdate=true,
              description="If true reverses the slider values from their normal order")
public void setInverted(boolean b)

Установите значение true, чтобы инвертировать диапазон значений, отображаемых для ползунка, и false, чтобы установить диапазон значений в нормальном порядке. Порядок зависит от свойства ComponentOrientation ползунка. Для горизонтальных ползунков без инвертирования (нормальное расположение) со значением ComponentOrientation максимальное значение находится справа. Для горизонтальных ползунков без инвертирования со значением ComponentOrientation максимальное значение находится слева. Для вертикальных ползунков максимальное значение находится сверху. Эти метки инвертируются, когда ползунок инвертирован.

По умолчанию это свойство имеет значение false.

Параметры:
b - true для инвертирования значений ползунка в обратном порядке

getMajorTickSpacing

public int getMajorTickSpacing()

Этот метод возвращает интервал для основных рисок. Возвращаемое значение представляет собой расстояние в значениях между каждой основной риской. Если у вас есть ползунок с диапазоном от 0 до 50, а интервал основных рисок установлен в 10, вы получите основные риски рядом со следующими значениями: 0, 10, 20, 30, 40, 50.

Возвращает:
количество значений между основными рисками
См. также:
setMajorTickSpacing(int)

setMajorTickSpacing

@BeanProperty(visualUpdate=true,
              description="Sets the number of values between major tick marks.")
public void setMajorTickSpacing(int n)

Этот метод устанавливает интервал для основных рисок. Передаваемое значение представляет собой расстояние в значениях между каждой основной риской. Если у вас есть ползунок с диапазоном от 0 до 50, а интервал основных рисок установлен в 10, вы получите основные риски рядом со следующими значениями: 0, 10, 20, 30, 40, 50.

Для отображения основных рисок необходимо установить setPaintTicks в true.

Этот метод также создаст таблицу меток. Если таблицы меток еще нет, интервал основных рисок равен > 0, а getPaintLabels возвращает true, будет сгенерирована стандартная таблица меток (вызванием createStandardLabels) с метками на основных рисках. В примере выше вы получите текстовые метки: "0", "10", "20", "30", "40", "50". Таблица меток затем устанавливается на ползунке вызовом setLabelTable.

Параметры:
n - новое значение для свойства majorTickSpacing
См. также:
getMajorTickSpacing(), setPaintTicks(boolean), setLabelTable(java.util.Dictionary), createStandardLabels(int)

getMinorTickSpacing

public int getMinorTickSpacing()

Этот метод возвращает интервал между метками меньшего масштаба. Возвращаемое число представляет расстояние, измеренное в значениях, между каждой меткой меньшего масштаба. Если у вас есть ползунок с диапазоном от 0 до 50, а интервал меток меньшего масштаба установлен в 10, вы получите метки меньшего масштаба рядом со следующими значениями: 0, 10, 20, 30, 40, 50.

Возвращает:
количество значений между метками меньшего масштаба
См. также:
getMinorTickSpacing()

setMinorTickSpacing

@BeanProperty(visualUpdate=true,
              description="Sets the number of values between minor tick marks.")
public void setMinorTickSpacing(int n)

Этот метод устанавливает интервал между метками меньшего масштаба. Передаваемое число представляет расстояние, измеренное в значениях, между каждой меткой меньшего масштаба. Если у вас есть ползунок с диапазоном от 0 до 50, а интервал меток меньшего масштаба установлен в 10, вы получите метки меньшего масштаба рядом со следующими значениями: 0, 10, 20, 30, 40, 50.

Для того, чтобы метки меньшего масштаба были нарисованы, setPaintTicks должно быть установлено в true.

Параметры:
n - новое значение для свойства minorTickSpacing
См. также:
getMinorTickSpacing(), setPaintTicks(boolean)

getSnapToTicks

public boolean getSnapToTicks()

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

Возвращает:
true, если значение привязывается к ближайшей метке, иначе false
См. также:
setSnapToTicks(boolean)

setSnapToTicks

@BeanProperty(description="If true snap the knob to the nearest tick mark.")
public void setSnapToTicks(boolean b)

Указание true приводит к тому, что ручка (и представляемое ею значение данных) устанавливается на ближайшую метку рядом с тем местом, где пользователь расположил ручку. По умолчанию это свойство равно false.

Параметры:
b - true, чтобы привязать ручку к ближайшей метке
См. также:
getSnapToTicks()

getPaintTicks

public boolean getPaintTicks()

Указывает, должны ли быть нарисованы метки.

Возвращает:
true, если метки нарисованы, иначе false
См. также:
setPaintTicks(boolean)

setPaintTicks

@BeanProperty(visualUpdate=true,
              description="If true tick marks are painted on the slider.")
public void setPaintTicks(boolean b)

Определяет, должны ли быть нарисованы метки на ползунке. По умолчанию это свойство равно false.

Параметры:
b - нужно ли рисовать метки
См. также:
getPaintTicks()

getPaintTrack

public boolean getPaintTrack()

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

Возвращает:
true, если дорожка нарисована, иначе false
См. также:
setPaintTrack(boolean)

setPaintTrack

@BeanProperty(visualUpdate=true,
              description="If true, the track is painted on the slider.")
public void setPaintTrack(boolean b)

Определяет, должна ли быть нарисована дорожка на ползунке. По умолчанию это свойство равно true. Вид ползунка может игнорировать это свойство.

Параметры:
b - нужно ли рисовать дорожку ползунка
См. также:
getPaintTrack()

getPaintLabels

public boolean getPaintLabels()

Указывает, должны ли быть нарисованы метки.

Возвращает:
true, если метки нарисованы, иначе false
См. также:
setPaintLabels(boolean)

setPaintLabels

@BeanProperty(visualUpdate=true,
              description="If true labels are painted on the slider.")
public void setPaintLabels(boolean b)

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

Этот метод также создаст таблицу меток. Если еще нет таблицы меток, а интервал основных меток равен > 0, будет сгенерирована стандартная таблица меток (вызванная createStandardLabels) с метками на основных метках. Затем таблица меток устанавливается на ползунке с помощью вызова setLabelTable.

По умолчанию это свойство равно false.

Параметры:
b - нужно ли рисовать метки
См. также:
getPaintLabels(), getLabelTable(), createStandardLabels(int)

paramString

protected String paramString()

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

Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этого JSlider.

getAccessibleContext

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

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

Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJSlider, который служит AccessibleContext этого JSlider

© 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/JSlider.html

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