Класс JSlider

javax.swing.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.

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

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

Начиная с версии:: 1.2

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

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

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected ChangeEvent`	`changeEvent`	Для каждого экземпляра ползунка требуется только один `ChangeEvent`, поскольку единственное (доступное только для чтения) состояние события — это свойство источника.
`protected ChangeListener`	`changeListener`	changeListener (без суффикса) — это обработчик, который мы добавляем в модель ползунка.
`protected int`	`majorTickSpacing`	Количество значений между крупными делениями — большими отметками, разделяющими мелкие деления.
`protected int`	`minorTickSpacing`	Количество значений между мелкими делениями — небольшими отметками между крупными делениями.
`protected int`	`orientation`	Ориентация ползунка: горизонтальная или вертикальная. По умолчанию — горизонтальная.
`protected BoundedRangeModel`	`sliderModel`	Модель данных, которая обрабатывает числовые значения максимума, минимума и текущей позиции ползунка.
`protected boolean`	`snapToTicks`	Если значение равно true, бегунок (и представляемое им значение данных) перемещается к ближайшему делению относительно положения, заданного пользователем.

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе 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()`	Возвращает «extent» из `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()`	Возвращает объект пользовательского интерфейса, реализующий внешний вид этого компонента.
`String`	`getUIClassID()`	Возвращает имя класса внешнего вида, который отрисовывает этот компонент.
`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)`	Задает объект пользовательского интерфейса, реализующий внешний вид этого компонента.
`void`	`setValue(int n)`	Задает текущее значение ползунка, равное `n`.
`void`	`setValueIsAdjusting(boolean b)`	Задает свойство `valueIsAdjusting` модели.
`protected void`	`updateLabelUIs()`	Обновляет пользовательские интерфейсы меток в таблице меток, вызывая `updateUI` для каждой метки.
`void`	`updateUI()`	Сбрасывает свойство пользовательского интерфейса до значения из текущего внешнего вида.

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

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

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

sliderModel

protected BoundedRangeModel sliderModel

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

majorTickSpacing

protected int majorTickSpacing

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

minorTickSpacing

protected int minorTickSpacing

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

См. также:

snapToTicks

protected boolean snapToTicks

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

См. также:

orientation

protected int orientation

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

См. также:

changeListener

protected ChangeListener changeListener

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

См. также:

changeEvent

protected transient ChangeEvent changeEvent

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

См. также:

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

JSlider

public JSlider()

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

JSlider

public JSlider(int orientation)

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

Параметры:

orientation — ориентация ползунка

Исключения:

IllegalArgumentException — если ориентация не является одним из значений VERTICAL, HORIZONTAL

См. также:

JSlider

public JSlider(int min, int max)

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

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

Параметры:

min — минимальное значение ползунка

max — максимальное значение ползунка

См. также:

JSlider

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

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

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

Параметры:

min — минимальное значение ползунка

max — максимальное значение ползунка

value — начальное значение ползунка

См. также:

JSlider

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

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

Параметры:

orientation — ориентация ползунка

min — минимальное значение ползунка

max — максимальное значение ползунка

value — начальное значение ползунка

Исключения:

IllegalArgumentException — если ориентация не является одним из значений VERTICAL, HORIZONTAL

См. также:

JSlider

public JSlider(BoundedRangeModel brm)

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

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

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

getUI

public SliderUI getUI()

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

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

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 — объект внешнего вида и стиля SliderUI

См. также:

updateUI

public void updateUI()

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

Переопределено:

updateUI в классе JComponent

См. также:

getUIClassID

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

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

Переопределено:

getUIClassID в классе JComponent

Возвращает:

строку "SliderUI"

См. также:

createChangeListener

protected ChangeListener createChangeListener()

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

Возвращает:

экземпляр нового ChangeListener

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

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

Параметры:

l — добавляемый ChangeListener

См. также:

removeChangeListener

public void removeChangeListener(ChangeListener l)

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

Параметры:

l — удаляемый ChangeListener

См. также:

getChangeListeners

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

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

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

fireStateChanged

protected void fireStateChanged()

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

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

См. также:

getModel

public BoundedRangeModel getModel()

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

Возвращает:

модель данных этого компонента

См. также:

setModel

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

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

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

Параметры:

newModel — новая non-null BoundedRangeModel для использования

См. также:

getValue

public int getValue()

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

Возвращает:

текущее значение ползунка

См. также:

setValue

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

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

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

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

Параметры:

n — новое значение

См. также:

getMinimum

public int getMinimum()

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

Возвращает:

значение свойства минимального значения модели

См. также:

setMinimum

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

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

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

Параметры:

minimum — новое минимальное значение

См. также:

getMaximum

public int getMaximum()

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

Возвращает:

значение свойства максимального значения модели

См. также:

setMaximum

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

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

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

Параметры:

maximum — новое максимальное значение

См. также:

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

Возвращает:

значение свойства valueIsAdjusting модели

См. также:

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

См. также:

getExtent

public int getExtent()

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

Возвращает:

целое число, представляющее размер

См. также:

setExtent

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

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

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

Параметры:

extent — новый размер

См. также:

getOrientation

public int getOrientation()

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

Возвращает:

SwingConstants.VERTICAL или SwingConstants.HORIZONTAL

См. также:

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

См. также:

setFont

public void setFont(Font font)

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

Переопределяет:

setFont в классе JComponent

Параметры:

font — требуемый Font для этого компонента

С версии:

1.6

См. также:

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, если флаги информации указывают, что изображение полностью загружено; в противном случае — true.

С версии:

1.7

См. также:

getLabelTable

public Dictionary getLabelTable()

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

Возвращает:: Dictionary, содержащий метки и указания, где их отображать

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 для удаления всех меток

См. также:

updateLabelUIs

protected void updateLabelUIs()

Обновляет пользовательские интерфейсы меток в таблице, вызывая 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 меньше или равно нулю

См. также:

createStandardLabels

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

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

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

Параметры:

increment — расстояние между метками в создаваемой хеш-таблице

start — значение, с которого начинаются метки

Возвращает:

новый Hashtable меток

Вызывает исключение:

IllegalArgumentException — если start находится вне допустимого диапазона или increment меньше или равно нулю

См. также:

getInverted

public boolean getInverted()

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

Возвращает:

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

См. также:

setInverted

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

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

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

Параметры:: b — true, чтобы расположить значения ползунка в обратном относительно обычного порядке

getMajorTickSpacing

public int getMajorTickSpacing()

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

Возвращает:

количество значений между основными делениями

См. также:

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

См. также:

getMinorTickSpacing

public int getMinorTickSpacing()

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

Возвращает:

количество значений между дополнительными делениями

См. также:

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

См. также:

getSnapToTicks

public boolean getSnapToTicks()

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

Возвращает:

true, если значение привязывается к ближайшему делению, иначе false

См. также:

setSnapToTicks

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

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

Параметры:

b — true, чтобы привязать бегунок к ближайшему делению

См. также:

getPaintTicks

public boolean getPaintTicks()

Определяет, отображаются ли деления.

Возвращает:

true, если деления отображаются, иначе false

См. также:

setPaintTicks

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

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

Параметры:

b — следует ли отображать деления

См. также:

getPaintTrack

public boolean getPaintTrack()

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

Возвращает:

true, если дорожка отображается, иначе false

См. также:

setPaintTrack

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

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

Параметры:

b — следует ли отображать дорожку ползунка

См. также:

getPaintLabels

public boolean getPaintLabels()

Определяет, отображаются ли метки.

Возвращает:

true, если метки отображаются, иначе false

См. также:

setPaintLabels

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

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

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

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

Параметры:

b — следует ли отображать метки

См. также:

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