Класс 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

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

См. также:

snapToTicks

protected boolean snapToTicks

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

См. также:

orientation

protected int orientation

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

См. также:

changeListener

protected 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, реализующий 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 , которые были добавлены непосредственно в ползунок.

Возвращает:

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

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

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

Параметры:

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

См. также:

removeChangeListener

public void removeChangeListener(ChangeListener l)

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

Parameters:

l - ChangeListener для удаления

See Also:

getChangeListeners

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

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

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

fireStateChanged

protected void fireStateChanged()

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

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

See Also:

getModel

public BoundedRangeModel getModel()

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

Returns:

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

See Also:

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:

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:

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:

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

Returns:

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

See Also:

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

@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:

setFont

public void setFont(Font font)

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

Overrides:

setFont in class JComponent

Parameters:

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

Since:

1.6

See Also:

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.

Specified by:

imageUpdate in interface ImageObserver

Overrides:

imageUpdate in class 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:

updateLabelUIs

protected void updateLabelUIs()

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

See Also:

createStandardLabels

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

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

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

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

Parameters:

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

Returns:

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

Throws:

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

See Also:

createStandardLabels

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

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

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

Parameters:

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

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

Returns:

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

Throws:

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

See Also:

getInverted

public boolean getInverted()

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

Returns:

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

See Also:

setInverted

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

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

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

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

getMajorTickSpacing

public int getMajorTickSpacing()

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

Returns:

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

See Also:

END_OF_DOCUMENT_MARKER

Установить интервал основных делений

@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

См. также:

Получить интервал второстепенных делений

public int getMinorTickSpacing()

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

Возвращает:

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

См. также:

Установить интервал второстепенных делений

@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

См. также:

Получить привязку к делениям

public boolean getSnapToTicks()

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

Возвращает:

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

См. также:

Установить привязку к делениям

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

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

Параметры:

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

См. также:

Получить рисовать деления

public boolean getPaintTicks()

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

Возвращает:

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

См. также:

Установить рисовать деления

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

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

Параметры:

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

См. также:

Получить рисовать дорожку

public boolean getPaintTrack()

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

Возвращает:

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

См. также:

Установить рисовать дорожку

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

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

Параметры:

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

См. также:

Получить рисовать метки

public boolean getPaintLabels()

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

Возвращает:

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

См. также:

Установить рисовать метки

@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, 2023, 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/21/docs/api/java.desktop/javax/swing/JSlider.html