Класс 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, добавлена поддержка долгосрочного хранения всех 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`	Слушатель 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)`	Создает горизонтальный ползунок с указанными min и max значениями, начальное значение равно среднему значению min + max.
`JSlider(int min, int max, int value)`	Создает горизонтальный ползунок с указанными min, max и значением.
`JSlider(int orientation, int min, int max, int value)`	Создает ползунок с указанной ориентацией и заданными минимальным, максимальным и начальным значениями.
`JSlider(BoundedRangeModel brm)`	Создает горизонтальный ползунок, используя заданную BoundedRangeModel.

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

Modifier and Type	Method	Description
`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, 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

Методы, объявленные в классе 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, 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, которое по умолчанию просто пересылает события слушателям (если таковые имеются), добавленным непосредственно к ползунку.

См. также:

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.

Параметры:

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 - объект SliderUI L&F

См. также:

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"

См. также:

createChangeListener

protected ChangeListener createChangeListener()

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

Возвращает:

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

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

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

Параметры:

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

См. также:

fireStateChanged()
removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет обработчик изменений из ползунка.

Parameters:

l - обработчик изменений для удаления

See Also:

fireStateChanged()
addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

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

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

Returns:: все добавленные обработчики изменений или пустой массив, если обработчики не добавлены
Since:: 1.4

fireStateChanged

protected void fireStateChanged()

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

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

See Also:

addChangeListener(javax.swing.event.ChangeListener)
EventListenerList

getModel

public BoundedRangeModel getModel()

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

Returns:

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

See Also:

setModel(javax.swing.BoundedRangeModel)
BoundedRangeModel

setModel

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

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

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

Parameters:

newModel - новая модель, используемая для non-null BoundedRangeModel

See Also:

getValue

public int getValue()

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

Returns:

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

See Also:

setValue

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

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

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

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

Parameters:

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

See Also:

getValue()
addChangeListener(javax.swing.event.ChangeListener)
BoundedRangeModel.setValue(int)

getMinimum

public int getMinimum()

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

Returns:

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

See Also:

setMinimum

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

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

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

Parameters:

minimum - новый минимум

See Also:

getMinimum()
addChangeListener(javax.swing.event.ChangeListener)
BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()

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

Returns:

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

See Also:

setMaximum

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

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

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

Parameters:

maximum - новый максимум

See Also:

getMaximum()
addChangeListener(javax.swing.event.ChangeListener)
BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

Returns:

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

See Also:

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, когда перетаскивание заканчивается.

Parameters:

b - новое значение для свойства valueIsAdjusting

See Also:

getExtent

public int getExtent()

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

Returns:

целое число, представляющее ширину

See Also:

setExtent

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

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

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

Parameters:

extent - новая ширина

See Also:

getOrientation

public int getOrientation()

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

Returns:

SwingConstants.VERTICAL или SwingConstants.HORIZONTAL

See Also:

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.

Parameters:

orientation - HORIZONTAL или VERTICAL

Throws:

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

See Also:

getOrientation()

END_OF_DOCUMENT_MARKER

setFont

public void setFont(Font font)

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

Overrides:

setFont в классе JComponent

Parameters:

font - требуемый шрифт для этого компонента

Since:

1.6

See Also:

Component.getFont()

imageUpdate

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

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

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

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

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

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

Specified by:

imageUpdate в интерфейсе ImageObserver

Overrides:

imageUpdate в классе Component

Parameters:

img - наблюдаемое изображение

infoflags - см. imageUpdate для получения дополнительной информации

x - координата x

y - координата y

w - ширина

h - высота

Returns:

false если флаги инфообработки указывают, что изображение загружено полностью; true в противном случае.

Since:

1.7

See Also:

getLabelTable

public Dictionary getLabelTable()

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

Returns:: словарь, содержащий метки и места их отображения

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.

Parameters:

labels - новый словарь меток или null для удаления всех меток

See Also:

createStandardLabels(int)
getLabelTable()
setPaintLabels(boolean)

updateLabelUIs

protected void updateLabelUIs()

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

See Also:

setLabelTable(java.util.Dictionary)
JComponent.updateUI()

createStandardLabels

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

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

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

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

Parameters:

increment - расстояние между метками в сгенерированном словаре

Returns:

новый словарь меток

Throws:

IllegalArgumentException - если increment меньше или равно нулю

See Also:

setLabelTable(java.util.Dictionary)
setPaintLabels(boolean)

createStandardLabels

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

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

Parameters:

increment - расстояние между метками в сгенерированном словаре

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

Returns:

новый словарь меток

Throws:

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

See Also:

setLabelTable(java.util.Dictionary)
setPaintLabels(boolean)

getInverted

public boolean getInverted()

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

Returns:

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

See Also:

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 значением LEFT_TO_RIGHT, максимальное значение находится справа. Для горизонтальных ползунков с ComponentOrientation значением RIGHT_TO_LEFT, максимальное значение находится слева. Для вертикальных ползунков максимальное значение находится сверху. Эти метки инвертируются, когда ползунок инвертирован.

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

Parameters:: b - true для инвертирования значений ползунка относительно их нормального порядка

getMajorTickSpacing

public int getMajorTickSpacing()

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

Returns:

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

See Also:

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.

Parameters:

n - новое значение для свойства majorTickSpacing

See Also:

getMajorTickSpacing()
setPaintTicks(boolean)
setLabelTable(java.util.Dictionary)
createStandardLabels(int)

getMinorTickSpacing

public int getMinorTickSpacing()

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

Returns:

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

See Also:

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.

Parameters:

n - новое значение для свойства minorTickSpacing

See Also:

getMinorTickSpacing()
setPaintTicks(boolean)

getSnapToTicks

public boolean getSnapToTicks()

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

Returns:

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

See Also:

setSnapToTicks(boolean)

setSnapToTicks

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

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

Parameters:

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

See Also:

getSnapToTicks()

getPaintTicks

public boolean getPaintTicks()

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

Returns:

true, если отметки нарисованы, иначе false

See Also:

setPaintTicks(boolean)

setPaintTicks

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

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

Parameters:

b - нужно ли рисовать отметки

See Also:

getPaintTicks()

getPaintTrack

public boolean getPaintTrack()

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

Returns:

true, если дорожка нарисована, иначе false

See Also:

setPaintTrack(boolean)

setPaintTrack

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

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

Parameters:

b - нужно ли рисовать дорожку ползунка

See Also:

getPaintTrack()

getPaintLabels

public boolean getPaintLabels()

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

Returns:

true, если метки нарисованы, иначе false

See Also:

setPaintLabels(boolean)

setPaintLabels

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

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

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

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

Parameters:

b - нужно ли рисовать метки

See Also:

getPaintLabels()
getLabelTable()
createStandardLabels(int)

paramString

protected String paramString()

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

Overrides:: paramString в классе JComponent
Returns:: строковое представление этого JSlider.

getAccessibleContext

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

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: AccessibleJSlider, служащий AccessibleContext этого JSlider

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/JSlider.html