Класс 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 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`	Слушатель 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.

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

Модификатор и тип	Метод	Описание
`void`	`addChangeListener(ChangeListener l)`	Добавляет ChangeListener к ползунку.
`protected ChangeListener`	`createChangeListener()`	Подклассы, которые хотят обрабатывать `ChangeEvent` от модели по-другому, могут переопределить этот метод, чтобы вернуть экземпляр кастомной реализации `ChangeListener`.
`Hashtable<Integer, JComponent>`	`createStandardLabels(int increment)`	Создаёт массив текстовых меток числовых значений, начиная с минимального значения ползунка и используя указанный шаг.
`Hashtable<Integer, JComponent>`	`createStandardLabels(int increment, int start)`	Создаёт массив текстовых меток числовых значений, начиная с указанной начальной точки и используя указанный шаг.
`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

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

См. также:

snapToTicks

protected boolean snapToTicks

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

См. также:

orientation

protected int orientation

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

См. также:

changeListener

protected ChangeListener changeListener

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

См. также:

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, реализующий 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

См. также:

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

См. также:

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

Обновляет интерфейсы (UI) меток в таблице меток, вызывая 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.

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

getAccessibleContext

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

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JSlider.html