Класс JSlider

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JSlider

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

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.

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

Модификатор и тип	Класс и описание
`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

Поля, унаследованные от интерфейса 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

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

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

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

Конструктор и описание
`JSlider()` Создаёт горизонтальный ползунок с диапазоном от 0 до 100 и начальным значением 50.
`JSlider(BoundedRangeModel brm)` Создаёт горизонтальный ползунок, используя указанную модель BoundedRangeModel.
`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)` Создаёт ползунок с указанной ориентацией и заданными минимальным, максимальным и начальными значениями.

Методы

Модификатор и тип	Метод и описание
`void`	`addChangeListener(ChangeListener l)` Добавляет ChangeListener к ползунку.
`protected ChangeListener`	`createChangeListener()` Подклассы, которые хотят обрабатывать `ChangeEvent` от модели по-другому, могут переопределить этот метод, чтобы вернуть экземпляр пользовательской реализации `ChangeListener`.
`Hashtable`	`createStandardLabels(int increment)` Создаёт набор числовых текстовых меток, начиная с минимального значения ползунка и используя указанный шаг.
`Hashtable`	`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, 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, унаследованные от класса java.lang.Object

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

Поля

sliderModel

protected BoundedRangeModel sliderModel

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

majorTickSpacing

protected int majorTickSpacing

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

minorTickSpacing

protected int minorTickSpacing

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

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

snapToTicks

protected boolean snapToTicks

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

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

orientation

protected int orientation

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

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

changeListener

protected ChangeListener changeListener

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

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

changeEvent

protected transient ChangeEvent changeEvent

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

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

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

JSlider

public JSlider()

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

JSlider

public JSlider(int orientation)

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

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

JSlider

public JSlider(int min,
               int max)

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

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

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

JSlider

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

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

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

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

JSlider

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

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

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

JSlider

public JSlider(BoundedRangeModel brm)

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

Методы

getUI

public SliderUI getUI()

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

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

setUI

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

public String getUIClassID()

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

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

createChangeListener

protected ChangeListener createChangeListener()

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

См. также:: changeListener, fireStateChanged(), ChangeListener, BoundedRangeModel

addChangeListener

public void addChangeListener(ChangeListener l)

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

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

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

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

getChangeListeners

public ChangeListener[] getChangeListeners()

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

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

fireStateChanged

protected void fireStateChanged()

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

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

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

getModel

public BoundedRangeModel getModel()

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

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

setModel

public void setModel(BoundedRangeModel newModel)

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

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

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

getValue

public int getValue()

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

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

setValue

public void setValue(int n)

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

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

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

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

getMinimum

public int getMinimum()

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

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

setMinimum

public void setMinimum(int minimum)

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

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

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

getMaximum

public int getMaximum()

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

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

setMaximum

public void setMaximum(int maximum)

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

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

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

getValueIsAdjusting

public boolean getValueIsAdjusting()

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

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

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

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

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

getExtent

public int getExtent()

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

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

setExtent

public void setExtent(int extent)

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

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

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

getOrientation

public int getOrientation()

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

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

setOrientation

public void setOrientation(int orientation)

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

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

setFont

public void setFont(Font font)

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

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

imageUpdate

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

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

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

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

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

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

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

getLabelTable

public Dictionary getLabelTable()

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

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

setLabelTable

public void setLabelTable(Dictionary labels)

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

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

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

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

updateLabelUIs

protected void updateLabelUIs()

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

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

createStandardLabels

public Hashtable createStandardLabels(int increment)

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

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

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

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

createStandardLabels

public Hashtable createStandardLabels(int increment,
                                      int start)

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

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

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

getInverted

public boolean getInverted()

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

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

setInverted

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(int)

setMajorTickSpacing

public void setMajorTickSpacing(int n)

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

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

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

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

getMinorTickSpacing

public int getMinorTickSpacing()

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

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

setMinorTickSpacing

public void setMinorTickSpacing(int n)

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

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

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

getSnapToTicks

public boolean getSnapToTicks()

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

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

setSnapToTicks

public void setSnapToTicks(boolean b)

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

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

getPaintTicks

public boolean getPaintTicks()

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

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

setPaintTicks

public void setPaintTicks(boolean b)

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

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

getPaintTrack

public boolean getPaintTrack()

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

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

setPaintTrack

public void setPaintTrack(boolean b)

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

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

getPaintLabels

public boolean getPaintLabels()

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

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

setPaintLabels

public void setPaintLabels(boolean b)

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

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

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

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

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.