icy.gui.component

Class RangeSlider

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JSlider

icy.gui.component.RangeSlider

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.SwingConstants

public class RangeSlider
extends javax.swing.JSlider

An extension of JSlider to select a range of values using two thumb controls. The thumb controls are used to select the lower and upper value of a range with predetermined minimum and maximum values.

Note that RangeSlider makes use of the default BoundedRangeModel, which supports an inner range defined by a value and an extent. The upper value returned by RangeSlider is simply the lower value plus the extent.

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JComponent.AccessibleJComponent

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

java.awt.Component.BaselineResizeBehavior

Field Summary

Fields inherited from class javax.swing.JComponent

TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
RangeSlider() Creates a horizontal range slider with the range 0 to 100 and an initial value of 50.
RangeSlider(int orientation) Creates a range slider using the specified orientation with the range 0 to 100 and an initial value of 50.
RangeSlider(int min, int max) Creates a horizontal range slider using the specified min and max with an initial value equal to the average of the min plus max.
RangeSlider(int min, int max, int low, int high) Creates a horizontal range slider using the specified min, max and value.
RangeSlider(int orientation, int min, int max, int low, int high) Creates a range slider with the specified orientation and the specified minimum, maximum, initial values and extend.

Method Summary

Methods

Modifier and Type	Method and Description
int	getLowerValue() Returns the lower value in the range.
int	getUpperValue() Returns the upper value in the range.
int	getValue() Returns the lower value in the range.
void	setFocusable(boolean focusable)
void	setLowerValue(int value) Sets the lower value in the range.
void	setUpperValue(int value) Sets the upper value in the range.
void	setValue(int value) Sets the lower value in the range.
void	updateUI() Overrides the superclass method to install the UI delegate to draw two thumbs.

Methods inherited from class javax.swing.JSlider

addChangeListener, createStandardLabels, createStandardLabels, getAccessibleContext, getChangeListeners, getExtent, getInverted, getLabelTable, getMajorTickSpacing, getMaximum, getMinimum, getMinorTickSpacing, getModel, getOrientation, getPaintLabels, getPaintTicks, getPaintTrack, getSnapToTicks, getUI, getUIClassID, getValueIsAdjusting, imageUpdate, removeChangeListener, setExtent, setFont, setInverted, setLabelTable, setMajorTickSpacing, setMaximum, setMinimum, setMinorTickSpacing, setModel, setOrientation, setPaintLabels, setPaintTicks, setPaintTrack, setSnapToTicks, setUI, setValueIsAdjusting

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, 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, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, 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, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, 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, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, 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, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RangeSlider

public RangeSlider(int orientation,
           int min,
           int max,
           int low,
           int high)

Creates a range slider with the specified orientation and the specified minimum, maximum, initial values and extend. The orientation can be either SwingConstants.VERTICAL or SwingConstants.HORIZONTAL.

The BoundedRangeModel that holds the slider's data handles any issues that may arise from improperly setting the minimum, initial, and maximum values on the slider. See the BoundedRangeModel documentation for details.

Parameters:

orientation - the orientation of the slider

min - the minimum value of the slider

max - the maximum value of the slider

low - the lower range value of the slider

high - the higher range value of the slider

Throws:

java.lang.IllegalArgumentException - if orientation is not one of VERTICAL, HORIZONTAL

See Also:

BoundedRangeModel, JSlider.setOrientation(int), JSlider.setMinimum(int), JSlider.setMaximum(int), setLowerValue(int), setUpperValue(int)

RangeSlider

public RangeSlider(int min,
           int max,
           int low,
           int high)

Creates a horizontal range slider using the specified min, max and value.

The BoundedRangeModel that holds the slider's data handles any issues that may arise from improperly setting the minimum, initial, and maximum values on the slider. See the BoundedRangeModel documentation for details.

Parameters:

min - the minimum value of the slider

max - the maximum value of the slider

low - the lower range value of the slider

high - the higher range value of the slider

See Also:

BoundedRangeModel, JSlider.setMinimum(int), JSlider.setMaximum(int), setLowerValue(int), setUpperValue(int)

RangeSlider

public RangeSlider(int min,
           int max)

Creates a horizontal range slider using the specified min and max with an initial value equal to the average of the min plus max.

The BoundedRangeModel that holds the slider's data handles any issues that may arise from improperly setting the minimum and maximum values on the slider. See the BoundedRangeModel documentation for details.

Parameters:

min - the minimum value of the slider

max - the maximum value of the slider

See Also:

BoundedRangeModel, JSlider.setMinimum(int), JSlider.setMaximum(int)

RangeSlider

public RangeSlider(int orientation)

Creates a range slider using the specified orientation with the range 0 to 100 and an initial value of 50. The orientation can be either SwingConstants.VERTICAL or SwingConstants.HORIZONTAL.

Parameters:

orientation - the orientation of the slider

Throws:

java.lang.IllegalArgumentException - if orientation is not one of VERTICAL, HORIZONTAL

See Also:

JSlider.setOrientation(int)

RangeSlider

public RangeSlider()

Creates a horizontal range slider with the range 0 to 100 and an initial value of 50.

Method Detail

setFocusable

public void setFocusable(boolean focusable)

Overrides:

setFocusable in class java.awt.Component

updateUI

public void updateUI()

Overrides the superclass method to install the UI delegate to draw two thumbs.

Overrides:

updateUI in class javax.swing.JSlider

getValue

public int getValue()

Returns the lower value in the range.

Overrides:

getValue in class javax.swing.JSlider

setValue

public void setValue(int value)

Sets the lower value in the range.

Overrides:

setValue in class javax.swing.JSlider

getLowerValue

public int getLowerValue()

Returns the lower value in the range.

setLowerValue

public void setLowerValue(int value)

Sets the lower value in the range.

getUpperValue

public int getUpperValue()

Returns the upper value in the range.

setUpperValue

public void setUpperValue(int value)

Sets the upper value in the range.