Package edu.cnu.mdi.component

Class RangeSlider

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

edu.cnu.mdi.component.RangeSlider

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class RangeSlider
extends JPanel

A simple utility component that wraps a JSlider and an optional label that displays the current slider value.

The RangeSlider supports two callback hooks:

• setOnChange(Consumer) – invoked continuously as the user moves the slider
• setOnFinalChange(Consumer) – invoked once after the user stops adjusting

This makes the component suitable for interactive UI (continuous updates) and more expensive model / rendering updates (on final change).

See Also:

• Serialized Form

Nested Class Summary

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

JPanel.AccessibleJPanel

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.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JComponent

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

Fields inherited from class java.awt.Component

accessibleContext, 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

Constructor Summary

Constructors

Constructor	Description
RangeSlider(int min, int max, int defaultVal)	Constructs a slider with no tick marks and a visible value label.
RangeSlider(int min, int max, int defaultVal, boolean showValue)	Constructs a slider with optional value label and no ticks.
RangeSlider(int min, int max, int defaultVal, int majorTick, int minorTick)	Constructs a slider with ticks and a visible value label.
RangeSlider(int min, int max, int defaultVal, int majorTick, int minorTick, boolean showValue)	Full constructor with complete customization.

Method Summary

Modifier and Type	Method	Description
int	getMaximum()	Returns the slider's maximum value.
int	getMinimum()	Returns the slider's minimum value.
JSlider	getSlider()	Returns the underlying JSlider for users who need to add custom label tables or further tweak the component.
int	getValue()	Returns the current slider value.
void	setOnChange(Consumer<Integer> callback)	Registers a callback for continuous change notifications.
void	setOnFinalChange(Consumer<Integer> callback)	Registers a callback for final change notifications.
void	setValue(int value)	Programmatically sets the slider value.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class 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, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class 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

Methods inherited from class 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, 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

Methods inherited from class java.lang.Object

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

Constructor Details

RangeSlider

public RangeSlider(int min,
 int max,
 int defaultVal)

Constructs a slider with no tick marks and a visible value label.

RangeSlider

public RangeSlider(int min,
 int max,
 int defaultVal,
 boolean showValue)

Constructs a slider with optional value label and no ticks.

Parameters:

showValue - whether the current numeric value is shown

RangeSlider

public RangeSlider(int min,
 int max,
 int defaultVal,
 int majorTick,
 int minorTick)

Constructs a slider with ticks and a visible value label.

RangeSlider

public RangeSlider(int min,
 int max,
 int defaultVal,
 int majorTick,
 int minorTick,
 boolean showValue)

Full constructor with complete customization.

Tick spacing is applied conditionally and independently:

• Major ticks are set only if 0 < majorTick < max; otherwise major ticks are silently omitted (not clamped to a valid value).
• Minor ticks are set only if 0 < minorTick < majorTick, comparing against the parameter majorTick — not against whether major ticks actually ended up enabled. So it is possible to get minor ticks without major ticks, e.g. if majorTick >= max (major ticks omitted) but 0 < minorTick < majorTick still holds.

Parameters:

majorTick - major tick spacing; 0 (or >= max) for none

minorTick - minor tick spacing; 0 (or >= majorTick) for none

Throws:

IllegalArgumentException - if min > max, if defaultVal is outside [min, max], or if either tick spacing is negative

Method Details

setOnChange

public void setOnChange(Consumer<Integer> callback)

Registers a callback for continuous change notifications.

setOnFinalChange

public void setOnFinalChange(Consumer<Integer> callback)

Registers a callback for final change notifications.

getValue

public int getValue()

Returns the current slider value.

setValue

public void setValue(int value)

Programmatically sets the slider value.

getMinimum

public int getMinimum()

Returns the slider's minimum value.

getMaximum

public int getMaximum()

Returns the slider's maximum value.

getSlider

public JSlider getSlider()

Returns the underlying JSlider for users who need to add custom label tables or further tweak the component.