javax.swing

Class JSlider

Implemented Interfaces:
Accessible, ImageObserver, MenuContainer, Serializable, SwingConstants

public class JSlider
extends JComponent
implements SwingConstants, Accessible, ImageObserver, MenuContainer, Serializable

A visual component that allows selection of a value within a range by adjusting a thumb in a track. The values for the minimum, maximum, extent and value are stored in a DefaultBoundedRangeModel.

A JSlider component has the following properties:

Property Stored in Bound?
extent model no
inverted slider yes
labelTable slider yes
majorTickSpacing slider yes
maximum model yes
minimum model yes
minorTickSpacing slider yes
model slider yes
orientation slider yes
paintLabels slider yes
paintTicks slider yes
snapToTicks slider yes
value model no
valueIsAdjusting model no

The various behavioural aspects of these properties follows:

See Also:
Serialized Form

Nested Class Summary

protected class
JSlider.AccessibleJSlider
Provides the accessibility features for the JSlider component.

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

protected ChangeEvent
changeEvent
The change event that is passed to all listeners of this slider.
protected ChangeListener
changeListener
The listener that monitors the slider's model and forwards events to the slider's listeners (see createChangeListener()).
protected int
majorTickSpacing
The space/distance between major ticks.
protected int
minorTickSpacing
The space/distance between minor ticks.
protected int
orientation
The orientation (horizontal or vertical) of the slider.
protected BoundedRangeModel
sliderModel
The model used to store the slider's range and current value.
protected boolean
snapToTicks
Whether the slider snaps its values to ticks.

Fields inherited from class javax.swing.JComponent

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

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

Fields inherited from interface 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

Constructor Summary

JSlider()
Creates a new horizontal JSlider instance with a minimum of 0, a maximum of 100, and a value of 50.
JSlider(int orientation)
Creates a new JSlider instance with the given orientation and a minimum of 0, a maximum of 100, and a value of 50.
JSlider(int minimum, int maximum)
Creates a new horizontal JSlider instance with the given maximum and minimum and a value that is halfway between the minimum and the maximum.
JSlider(int minimum, int maximum, int value)
Creates a new horizontal JSlider instance with the given minimum, maximum, and value.
JSlider(int orientation, int minimum, int maximum, int value)
Creates a new JSlider instance with the given orientation, minimum, maximum, and value.
JSlider(BoundedRangeModel model)
Creates a new horizontal JSlider instance with the given model.

Method Summary

void
addChangeListener(ChangeListener listener)
Registers a listener with the slider so that it will receive ChangeEvent notifications.
protected ChangeListener
createChangeListener()
Creates a ChangeListener that is added to the slider's model and forwards change events generated by the model to the listeners that are registered with the JSlider (by calling the fireStateChanged() method).
Hashtable<K,V>
createStandardLabels(int increment)
Creates a hashtable of (Integer, JLabel) pairs that can be used as a label table for this slider.
Hashtable<K,V>
createStandardLabels(int increment, int start)
Creates a hashtable of (Integer, JLabel) pairs that can be used as a label table for this slider.
protected void
fireStateChanged()
Sends a ChangeEvent to all registered listeners, with this slider as the source.
AccessibleContext
getAccessibleContext()
Returns the object that provides accessibility features for this JSlider component.
ChangeListener[]
getChangeListeners()
Returns an array containing all the ChangeListener instances registered with this slider.
int
getExtent()
Returns the slider's extent value, obtained from the slider's model.
boolean
getInverted()
Returns the flag that controls whether or not the value scale for the slider is inverted (the default value is false).
Dictionary<K,V>
getLabelTable()
Returns the label table for the slider.
int
getMajorTickSpacing()
Returns the distance between major tick marks along the slider's value scale.
int
getMaximum()
Returns the slider's maximum value (obtained from the slider's model).
int
getMinimum()
Returns the minimum value of the slider (from the slider's model).
int
getMinorTickSpacing()
Returns the distance between minor tick marks along the slider's value scale.
BoundedRangeModel
getModel()
Returns the slider's model, which stores the minimum, maximum and current values.
int
getOrientation()
Returns the orientation of the slider, either SwingConstants.HORIZONTAL or SwingConstants.VERTICAL.
boolean
getPaintLabels()
Returns the flag that controls whether or not labels are painted for the tick marks along the slider.
boolean
getPaintTicks()
Returns the flag that controls whether or not tick marks are painted along the slider's value scale.
boolean
getPaintTrack()
Returns the flag that controls whether or not the track is painted.
boolean
getSnapToTicks()
Returns the flag that controls whether the slider thumb will snap to ticks.
SliderUI
getUI()
Returns the slider's UI delegate.
String
getUIClassID()
Returns the suffix ("SliderUI" in this case) used to determine the class name for a UI delegate that can provide the look and feel for a JSlider.
int
getValue()
Returns the slider's value (from the slider's model).
boolean
getValueIsAdjusting()
Returns the valueIsAdjusting flag from the slider's model.
protected String
paramString()
Returns an implementation-dependent string describing the attributes of this JSlider.
void
removeChangeListener(ChangeListener listener)
Removes a listener from this slider so that it will no longer receive ChangeEvent notifications from the slider.
void
setExtent(int extent)
Sets the slider's extent value and sends a ChangeEvent to all registered listeners.
void
setInverted(boolean inverted)
Sets the flag that controls whether or not the value scale for the slider is inverted and, if the new flag value is different to the old flag value, sends a PropertyChangeEvent to all registered listeners.
void
setLabelTable(Dictionary<K,V> table)
Sets the table of labels for the slider and sends a PropertyChangeEvent (with the property name "labelTable") to all registered listeners.
void
setMajorTickSpacing(int spacing)
Sets the distance between major tick marks along the slider's value scale, and sends a PropertyChangeEvent (with the property name "majorTickSpacing") to all registered listeners.
void
setMaximum(int maximum)
Sets the maximum value of the slider and fires a PropertyChangeEvent (with the property name "maximum") to all registered listeners.
void
setMinimum(int minimum)
Sets the minimum value of the slider and fires a PropertyChangeEvent (with the property name "minimum") to all registered listeners.
void
setMinorTickSpacing(int spacing)
Sets the distance between minor tick marks along the slider's value scale, and sends a PropertyChangeEvent (with the property name "minorTickSpacing") to all registered listeners.
void
setModel(BoundedRangeModel model)
Sets the slider's model and sends a PropertyChangeEvent (with the property name "model") to all registered listeners.
void
setOrientation(int orientation)
Sets the orientation for the slider and sends a PropertyChangeEvent (with the property name "orientation") to all registered listeners.
void
setPaintLabels(boolean paint)
Sets the flag that controls whether or not labels are painted for the tick marks along the slider and sends a PropertyChangeEvent (with the property name "paintLabels") to all registered listeners.
void
setPaintTicks(boolean paint)
Sets the flag that controls whether or not tick marks are painted along the slider's value scale, and sends a PropertyChangeEvent (with the property name "paintTicks") to all registered listeners.
void
setPaintTrack(boolean paint)
Sets the flag that controls whether or not the track is painted, and sends a PropertyChangeEvent (for the "paintTrack" property) to all registered listeners.
void
setSnapToTicks(boolean snap)
Sets the flag that controls whether the slider thumb will snap to ticks and sends a PropertyChangeEvent (with the property name 'snapToTicks') to all registered listeners.
void
setUI(SliderUI ui)
Sets the slider's UI delegate.
void
setValue(int value)
Sets the slider's value and sends a ChangeEvent to all registered listeners.
void
setValueIsAdjusting(boolean adjusting)
Sets the valueIsAdjusting flag in the slider's model, and sends a ChangeEvent to all registered listeners.
protected void
updateLabelUIs()
Resets the UI delegates for the labels in the labelTable to the default for the current look and feel.
void
updateUI()
Sets this slider's UI delegate to the default (obtained from the UIManager) for the current look and feel.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, extends EventListener> T[] getListeners, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, 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, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, extends EventListener> T[] getListeners, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponentZOrder, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, extends EventListener> T[] getListeners, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFocusable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFocusable, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

changeEvent

protected ChangeEvent changeEvent
The change event that is passed to all listeners of this slider.

changeListener

protected ChangeListener changeListener
The listener that monitors the slider's model and forwards events to the slider's listeners (see createChangeListener()).

majorTickSpacing

protected int majorTickSpacing
The space/distance between major ticks.

minorTickSpacing

protected int minorTickSpacing
The space/distance between minor ticks.

orientation

protected int orientation
The orientation (horizontal or vertical) of the slider.

sliderModel

protected BoundedRangeModel sliderModel
The model used to store the slider's range and current value.

snapToTicks

protected boolean snapToTicks
Whether the slider snaps its values to ticks.

Constructor Details

JSlider

public JSlider()
Creates a new horizontal JSlider instance with a minimum of 0, a maximum of 100, and a value of 50.

JSlider

public JSlider(int orientation)
Creates a new JSlider instance with the given orientation and a minimum of 0, a maximum of 100, and a value of 50.
Parameters:
orientation - The orientation of the slider (SwingConstants.HORIZONTAL or SwingConstants.VERTICAL).
Throws:
IllegalArgumentException - if orientation is not one of the specified values.

JSlider

public JSlider(int minimum,
               int maximum)
Creates a new horizontal JSlider instance with the given maximum and minimum and a value that is halfway between the minimum and the maximum.
Parameters:
minimum - The minimum value.
maximum - The maximum value.
Throws:
IllegalArgumentException - if minimum is greater than maximum.

JSlider

public JSlider(int minimum,
               int maximum,
               int value)
Creates a new horizontal JSlider instance with the given minimum, maximum, and value.
Parameters:
minimum - The minimum value.
maximum - The maximum value.
value - The initial value.
Throws:
IllegalArgumentException - if value is not in the specified range.
IllegalArgumentException - if minimum is greater than maximum.

JSlider

public JSlider(int orientation,
               int minimum,
               int maximum,
               int value)
Creates a new JSlider instance with the given orientation, minimum, maximum, and value.
Parameters:
orientation - The orientation of the slider (SwingConstants.HORIZONTAL or SwingConstants.VERTICAL).
minimum - The minimum value of the JSlider.
maximum - The maximum value of the JSlider.
value - The initial value of the JSlider.
Throws:
IllegalArgumentException - if orientation is not one of the specified values.
IllegalArgumentException - if value is not in the specified range.
IllegalArgumentException - if minimum is greater than maximum.

JSlider

public JSlider(BoundedRangeModel model)
Creates a new horizontal JSlider instance with the given model.
Parameters:
model - The model (null not permitted).
Throws:
NullPointerException - if model is null.

Method Details

addChangeListener

public void addChangeListener(ChangeListener listener)
Registers a listener with the slider so that it will receive ChangeEvent notifications. Note that change events generated by the slider's model will be forwarded automatically to the slider's listeners.
Parameters:
listener - the listener to register.

createChangeListener

protected ChangeListener createChangeListener()
Creates a ChangeListener that is added to the slider's model and forwards change events generated by the model to the listeners that are registered with the JSlider (by calling the fireStateChanged() method).
Returns:
A new listener.

createStandardLabels

public Hashtable<K,V> createStandardLabels(int increment)
Creates a hashtable of (Integer, JLabel) pairs that can be used as a label table for this slider. The labels will start from the slider's minimum and increase by the increment. Each label will have a text string indicating its integer value.
Parameters:
increment - The increment between labels (must be > 0).
Returns:
A hashtable containing the labels.
Throws:
IllegalArgumentException - if increment is not greater than zero.

createStandardLabels

public Hashtable<K,V> createStandardLabels(int increment,
                                      int start)
Creates a hashtable of (Integer, JLabel) pairs that can be used as a label table for this slider. The labels will start from the given start value and increase by the increment. Each label will have a text string indicating its integer value.
Parameters:
increment - The increment between labels (must be > 0).
start - The value to start from.
Returns:
A hashtable with the labels and their keys.
Throws:
IllegalArgumentException - if increment is not greater than zero, or start is not within the range of the model.

fireStateChanged

protected void fireStateChanged()
Sends a ChangeEvent to all registered listeners, with this slider as the source.

getAccessibleContext

public AccessibleContext getAccessibleContext()
Returns the object that provides accessibility features for this JSlider component.
Specified by:
getAccessibleContext in interface Accessible
Overrides:
getAccessibleContext in interface JComponent
Returns:
The accessible context (an instance of JSlider.AccessibleJSlider).

getChangeListeners

public ChangeListener[] getChangeListeners()
Returns an array containing all the ChangeListener instances registered with this slider. If no listeners are registered, this method returns an empty array.
Returns:
An array array containing all the ChangeListener instances registered with this slider (possibly empty, but never null).

getExtent

public int getExtent()
Returns the slider's extent value, obtained from the slider's model.
Returns:
The extent value.

getInverted

public boolean getInverted()
Returns the flag that controls whether or not the value scale for the slider is inverted (the default value is false).
Returns:
The flag that controls whether or not the value scale for the slider is inverted.

getLabelTable

public Dictionary<K,V> getLabelTable()
Returns the label table for the slider.
Returns:
The label table for the slider (possibly null).

getMajorTickSpacing

public int getMajorTickSpacing()
Returns the distance between major tick marks along the slider's value scale.
Returns:
The amount of units between each major tick mark.

getMaximum

public int getMaximum()
Returns the slider's maximum value (obtained from the slider's model).
Returns:
The maximum value of the slider.

getMinimum

public int getMinimum()
Returns the minimum value of the slider (from the slider's model).
Returns:
The minimum value of the slider.

getMinorTickSpacing

public int getMinorTickSpacing()
Returns the distance between minor tick marks along the slider's value scale.
Returns:
The distance between minor tick marks along the slider's value scale.

getModel

public BoundedRangeModel getModel()
Returns the slider's model, which stores the minimum, maximum and current values.
Returns:
The slider's model.

getOrientation

public int getOrientation()
Returns the orientation of the slider, either SwingConstants.HORIZONTAL or SwingConstants.VERTICAL.
Returns:
The orientation of the slider.

getPaintLabels

public boolean getPaintLabels()
Returns the flag that controls whether or not labels are painted for the tick marks along the slider.
Returns:
Whether labels will be painted.

getPaintTicks

public boolean getPaintTicks()
Returns the flag that controls whether or not tick marks are painted along the slider's value scale.
Returns:
true if tick marks should be painted, and false if tick marks should not be painted.

getPaintTrack

public boolean getPaintTrack()
Returns the flag that controls whether or not the track is painted.
Returns:
Whether the track will be painted.

getSnapToTicks

public boolean getSnapToTicks()
Returns the flag that controls whether the slider thumb will snap to ticks. Sliders that snap to ticks will automatically move the thumb to the nearest tick mark.
Returns:
true if the slider thumb automatically.

getUI

public SliderUI getUI()
Returns the slider's UI delegate.
Returns:
The slider's UI delegate.

getUIClassID

public String getUIClassID()
Returns the suffix ("SliderUI" in this case) used to determine the class name for a UI delegate that can provide the look and feel for a JSlider.
Overrides:
getUIClassID in interface JComponent
Returns:
"SliderUI".

getValue

public int getValue()
Returns the slider's value (from the slider's model).
Returns:
The value of the slider.
See Also:
setValue(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()
Returns the valueIsAdjusting flag from the slider's model.
Returns:
The valueIsAdjusting flag from the slider's model.

paramString

protected String paramString()
Returns an implementation-dependent string describing the attributes of this JSlider.
Overrides:
paramString in interface JComponent
Returns:
A string describing the attributes of this JSlider (never null).

removeChangeListener

public void removeChangeListener(ChangeListener listener)
Removes a listener from this slider so that it will no longer receive ChangeEvent notifications from the slider.
Parameters:
listener - The listener to remove.

setExtent

public void setExtent(int extent)
Sets the slider's extent value and sends a ChangeEvent to all registered listeners. Note that the model will fire a change event to all of its registered listeners first (with the model as the event source) and then the slider will fire another change event to all of its registered listeners (this time with the slider as the event source).
Parameters:
extent - The extent value for this slider.
See Also:
getExtent()

setInverted

public void setInverted(boolean inverted)
Sets the flag that controls whether or not the value scale for the slider is inverted and, if the new flag value is different to the old flag value, sends a PropertyChangeEvent to all registered listeners. Typically, a horizontal slider will display a scale that increases from left to right, but this is reversed if the 'inverted' flag is set to true. Similarly, a vertical slider will display a scale that increases from bottom to top, and this is reversed if the 'inverted' flag is set to true.
Parameters:
inverted - the new flag value.
See Also:
getInverted()

setLabelTable

public void setLabelTable(Dictionary<K,V> table)
Sets the table of labels for the slider and sends a PropertyChangeEvent (with the property name "labelTable") to all registered listeners.
Parameters:
table - the table of labels (null permitted).

setMajorTickSpacing

public void setMajorTickSpacing(int spacing)
Sets the distance between major tick marks along the slider's value scale, and sends a PropertyChangeEvent (with the property name "majorTickSpacing") to all registered listeners.
Parameters:
spacing - the distance between major tick marks.

setMaximum

public void setMaximum(int maximum)
Sets the maximum value of the slider and fires a PropertyChangeEvent (with the property name "maximum") to all registered listeners. Note that:

  • the maximum value is stored in the slider's model (see getModel());
  • in addition to the property change event, the slider also fires a ChangeEvent.
Parameters:
maximum - The maximum value of the slider.
See Also:
getMaximum()

setMinimum

public void setMinimum(int minimum)
Sets the minimum value of the slider and fires a PropertyChangeEvent (with the property name "minimum") to all registered listeners. Note that:

  • the minimum value is stored in the slider's model (see getModel());
  • in addition to the property change event, the slider also fires a ChangeEvent.
Parameters:
minimum - The minimum value of the slider.
See Also:
getMinimum()

setMinorTickSpacing

public void setMinorTickSpacing(int spacing)
Sets the distance between minor tick marks along the slider's value scale, and sends a PropertyChangeEvent (with the property name "minorTickSpacing") to all registered listeners.
Parameters:
spacing - the distance between minor tick marks.

setModel

public void setModel(BoundedRangeModel model)
Sets the slider's model and sends a PropertyChangeEvent (with the property name "model") to all registered listeners. The change listener that the slider registered with the original model is removed and added to the new model (this ensures that ChangeEvent notifications generated by the model are automatically forwarded to listeners that are registered with the slider).
Parameters:
model - The model to use with the slider.
See Also:
getModel()

setOrientation

public void setOrientation(int orientation)
Sets the orientation for the slider and sends a PropertyChangeEvent (with the property name "orientation") to all registered listeners.
Parameters:
orientation - the orientation (one of SwingConstants.HORIZONTAL or SwingConstants.VERTICAL).
Throws:
IllegalArgumentException - if orientation is not one of the permitted values.

setPaintLabels

public void setPaintLabels(boolean paint)
Sets the flag that controls whether or not labels are painted for the tick marks along the slider and sends a PropertyChangeEvent (with the property name "paintLabels") to all registered listeners.
Parameters:
paint - Whether labels will be painted.

setPaintTicks

public void setPaintTicks(boolean paint)
Sets the flag that controls whether or not tick marks are painted along the slider's value scale, and sends a PropertyChangeEvent (with the property name "paintTicks") to all registered listeners. In addition to setting this property to true, one or both of the minor tick spacing and major tick spacing attributes must be set to a value greater than 0 in order for ticks to be painted.
Parameters:
paint - Whether ticks will be painted.

setPaintTrack

public void setPaintTrack(boolean paint)
Sets the flag that controls whether or not the track is painted, and sends a PropertyChangeEvent (for the "paintTrack" property) to all registered listeners.
Parameters:
paint - Whether the track will be painted.

setSnapToTicks

public void setSnapToTicks(boolean snap)
Sets the flag that controls whether the slider thumb will snap to ticks and sends a PropertyChangeEvent (with the property name 'snapToTicks') to all registered listeners. Sliders that snap to ticks will automatically move the thumb to the nearest tick mark.
Parameters:
snap - the new flag value.

setUI

public void setUI(SliderUI ui)
Sets the slider's UI delegate.
Parameters:
ui - the UI delegate.

setValue

public void setValue(int value)
Sets the slider's value and sends a ChangeEvent to all registered listeners. Note that the model will fire a change event to all of its registered listeners first (with the model as the event source) and then the slider will fire another change event to all of its registered listeners (this time with the slider as the event source).
Parameters:
value - the new value.
See Also:
getValue()

setValueIsAdjusting

public void setValueIsAdjusting(boolean adjusting)
Sets the valueIsAdjusting flag in the slider's model, and sends a ChangeEvent to all registered listeners.
Parameters:
adjusting - the new flag value.

updateLabelUIs

protected void updateLabelUIs()
Resets the UI delegates for the labels in the labelTable to the default for the current look and feel.

updateUI

public void updateUI()
Sets this slider's UI delegate to the default (obtained from the UIManager) for the current look and feel.
Overrides:
updateUI in interface JComponent

JSlider.java -- Copyright (C) 2002, 2004, 2005, 2006, Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.