W3cubDocs

/OpenJDK 21

Class BasicSliderUI

Direct Known Subclasses:
MetalSliderUI, SynthSliderUI
public class BasicSliderUI extends SliderUI
A Basic L&F implementation of SliderUI.

Nested Class Summary

Modifier and Type Class Description
class  BasicSliderUI.ActionScroller
As of Java 2 platform v1.3 this undocumented class is no longer used.
class  BasicSliderUI.ChangeHandler
Data model listener.
class  BasicSliderUI.ComponentHandler
Listener for resizing events.
class  BasicSliderUI.FocusHandler
Focus-change listener.
class  BasicSliderUI.PropertyChangeHandler
A property change handler.
class  BasicSliderUI.ScrollListener
Scroll-event listener.
class  BasicSliderUI.TrackListener
Track mouse movements.

Field Summary

Modifier and Type Field Description
protected ChangeListener changeListener
Change listener
protected ComponentListener componentListener
Component listener
protected Rectangle contentRect
Content rectangle
protected Insets focusInsets
Focus insets
protected FocusListener focusListener
Focus listener
protected Rectangle focusRect
Focus rectangle
protected Insets insetCache
Inset cache
protected Rectangle labelRect
Label rectangle
protected boolean leftToRightCache
Left-to-right cache
static final int MAX_SCROLL
Maximum scroll
static final int MIN_SCROLL
Minimum scroll
static final int NEGATIVE_SCROLL
Negative scroll
static final int POSITIVE_SCROLL
Positive scroll
protected PropertyChangeListener propertyChangeListener
Property change listener
protected BasicSliderUI.ScrollListener scrollListener
Scroll listener
protected Timer scrollTimer
Scroll timer
protected JSlider slider
Slider
protected Rectangle thumbRect
Thumb rectangle
protected Rectangle tickRect
Tick rectangle
protected int trackBuffer
The distance that the track is from the side of the control
protected BasicSliderUI.TrackListener trackListener
Track listener
protected Rectangle trackRect
Track rectangle

Constructor Summary

Constructor Description
BasicSliderUI()
Constructs a BasicSliderUI.
BasicSliderUI(JSlider b)
Constructs a BasicSliderUI.

Method Summary

Modifier and Type Method Description
protected void calculateContentRect()
Calculates the content rectangle.
protected void calculateFocusRect()
Calculates the focus rectangle.
protected void calculateGeometry()
Calculates the geometry.
protected void calculateLabelRect()
Calculates the label rectangle.
protected void calculateThumbLocation()
Calculates the thumb location.
protected void calculateThumbSize()
Calculates the thumb size rectangle.
protected void calculateTickRect()
Calculates the tick rectangle.
protected void calculateTrackBuffer()
Calculates the track buffer.
protected void calculateTrackRect()
Calculates the track rectangle.
protected ChangeListener createChangeListener(JSlider slider)
Creates a change listener.
protected ComponentListener createComponentListener(JSlider slider)
Creates a composite listener.
protected FocusListener createFocusListener(JSlider slider)
Creates a focus listener.
protected PropertyChangeListener createPropertyChangeListener(JSlider slider)
Creates a property change listener.
protected BasicSliderUI.ScrollListener createScrollListener(JSlider slider)
Creates a scroll listener.
protected BasicSliderUI.TrackListener createTrackListener(JSlider slider)
Creates a track listener.
static ComponentUI createUI(JComponent b)
Creates a UI.
protected boolean drawInverted()
Draws inverted.
int getBaseline(JComponent c, int width, int height)
Returns the baseline.
Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)
Returns an enum indicating how the baseline of the component changes as the size changes.
protected Color getFocusColor()
Returns the focus color.
protected int getHeightOfHighValueLabel()
Returns the height of the highest value label.
protected int getHeightOfLowValueLabel()
Returns the height of the lowest value label.
protected int getHeightOfTallestLabel()
Returns the height of the tallest label.
protected Integer getHighestValue()
Returns the biggest value that has an entry in the label table.
protected Component getHighestValueLabel()
Returns the label that corresponds to the lowest slider value in the label table.
protected Color getHighlightColor()
Returns the highlight color.
protected Integer getLowestValue()
Returns the smallest value that has an entry in the label table.
protected Component getLowestValueLabel()
Returns the label that corresponds to the highest slider value in the label table.
Dimension getMaximumSize(JComponent c)
Returns the maximum size.
Dimension getMinimumHorizontalSize()
Returns the minimum horizontal size.
Dimension getMinimumSize(JComponent c)
Returns the minimum size.
Dimension getMinimumVerticalSize()
Returns the minimum vertical size.
Dimension getPreferredHorizontalSize()
Returns the preferred horizontal size.
Dimension getPreferredSize(JComponent c)
Returns the preferred size.
Dimension getPreferredVerticalSize()
Returns the preferred vertical size.
protected Color getShadowColor()
Returns the shadow color.
protected Dimension getThumbSize()
Returns the thumb size.
protected int getTickLength()
Gets the height of the tick area for horizontal sliders and the width of the tick area for vertical sliders.
protected int getWidthOfHighValueLabel()
Returns the width of the highest value label.
protected int getWidthOfLowValueLabel()
Returns the width of the lowest value label.
protected int getWidthOfWidestLabel()
Returns the width of the widest label.
protected void installDefaults(JSlider slider)
Installs the defaults.
protected void installKeyboardActions(JSlider slider)
Installs keyboard actions.
protected void installListeners(JSlider slider)
Installs listeners.
void installUI(JComponent c)
Installs a UI.
protected boolean isDragging()
Returns true if the user is dragging the slider.
protected boolean labelsHaveSameBaselines()
Returns true if all the labels from the label table have the same baseline.
void paintFocus(Graphics g)
Paints focus.
protected void paintHorizontalLabel(Graphics g, int value, Component label)
Called for every label in the label table.
void paintLabels(Graphics g)
Paints the labels.
protected void paintMajorTickForHorizSlider(Graphics g, Rectangle tickBounds, int x)
Paints major tick for horizontal slider.
protected void paintMajorTickForVertSlider(Graphics g, Rectangle tickBounds, int y)
Paints major tick for vertical slider.
protected void paintMinorTickForHorizSlider(Graphics g, Rectangle tickBounds, int x)
Paints minor tick for horizontal slider.
protected void paintMinorTickForVertSlider(Graphics g, Rectangle tickBounds, int y)
Paints minor tick for vertical slider.
void paintThumb(Graphics g)
Paints the thumb.
void paintTicks(Graphics g)
Paints ticks.
void paintTrack(Graphics g)
Paints track.
protected void paintVerticalLabel(Graphics g, int value, Component label)
Called for every label in the label table.
protected void recalculateIfInsetsChanged()
Recalculates if the insets have changed.
protected void recalculateIfOrientationChanged()
Recalculates if the orientation has changed.
void scrollByBlock(int direction)
Scrolls by block.
void scrollByUnit(int direction)
Scrolls by unit.
protected void scrollDueToClickInTrack(int dir)
This function is called when a mousePressed was detected in the track, not in the thumb.
void setThumbLocation(int x, int y)
Sets the thumb location.
protected void uninstallDefaults(JSlider slider)
Uninstalls the defaults.
protected void uninstallKeyboardActions(JSlider slider)
Uninstalls keyboard actions.
protected void uninstallListeners(JSlider slider)
Uninstalls listeners.
void uninstallUI(JComponent c)
Uninstalls a UI.
int valueForXPosition(int xPos)
Returns the value at the x position.
int valueForYPosition(int yPos)
Returns the value at the y position.
protected int xPositionForValue(int value)
Returns the x position for a value.
protected int yPositionForValue(int value)
Returns the y position for a value.
protected int yPositionForValue(int value, int trackY, int trackHeight)
Returns the y location for the specified value.

Methods declared in class javax.swing.plaf.ComponentUI

contains, getAccessibleChild, getAccessibleChildrenCount, paint, update

Methods declared in class java.lang.Object

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

Field Details

POSITIVE_SCROLL

public static final int POSITIVE_SCROLL
Positive scroll
See Also:

NEGATIVE_SCROLL

public static final int NEGATIVE_SCROLL
Negative scroll
See Also:

MIN_SCROLL

public static final int MIN_SCROLL
Minimum scroll
See Also:

MAX_SCROLL

public static final int MAX_SCROLL
Maximum scroll
See Also:

scrollTimer

protected Timer scrollTimer
Scroll timer

slider

protected JSlider slider
Slider

focusInsets

protected Insets focusInsets
Focus insets

insetCache

protected Insets insetCache
Inset cache

leftToRightCache

protected boolean leftToRightCache
Left-to-right cache

focusRect

protected Rectangle focusRect
Focus rectangle

contentRect

protected Rectangle contentRect
Content rectangle

labelRect

protected Rectangle labelRect
Label rectangle

tickRect

protected Rectangle tickRect
Tick rectangle

trackRect

protected Rectangle trackRect
Track rectangle

thumbRect

protected Rectangle thumbRect
Thumb rectangle

trackBuffer

protected int trackBuffer
The distance that the track is from the side of the control

trackListener

protected BasicSliderUI.TrackListener trackListener
Track listener

changeListener

protected ChangeListener changeListener
Change listener

componentListener

protected ComponentListener componentListener
Component listener

focusListener

protected FocusListener focusListener
Focus listener

scrollListener

protected BasicSliderUI.ScrollListener scrollListener
Scroll listener

propertyChangeListener

protected PropertyChangeListener propertyChangeListener
Property change listener

Constructor Details

BasicSliderUI

public BasicSliderUI()
Constructs a BasicSliderUI.

BasicSliderUI

public BasicSliderUI(JSlider b)
Constructs a BasicSliderUI.
Parameters:
b - a slider

Method Details

getShadowColor

protected Color getShadowColor()
Returns the shadow color.
Returns:
the shadow color

getHighlightColor

protected Color getHighlightColor()
Returns the highlight color.
Returns:
the highlight color

getFocusColor

protected Color getFocusColor()
Returns the focus color.
Returns:
the focus color

isDragging

protected boolean isDragging()
Returns true if the user is dragging the slider.
Returns:
true if the user is dragging the slider
Since:
1.5

createUI

public static ComponentUI createUI(JComponent b)
Creates a UI.
Parameters:
b - a component
Returns:
a UI

installUI

public void installUI(JComponent c)
Installs a UI.
Overrides:
installUI in class ComponentUI
Parameters:
c - a component
See Also:

uninstallUI

public void uninstallUI(JComponent c)
Uninstalls a UI.
Overrides:
uninstallUI in class ComponentUI
Parameters:
c - a component
See Also:

installDefaults

protected void installDefaults(JSlider slider)
Installs the defaults.
Parameters:
slider - a slider

uninstallDefaults

protected void uninstallDefaults(JSlider slider)
Uninstalls the defaults.
Parameters:
slider - a slider

createTrackListener

protected BasicSliderUI.TrackListener createTrackListener(JSlider slider)
Creates a track listener.
Parameters:
slider - a slider
Returns:
a track listener

createChangeListener

protected ChangeListener createChangeListener(JSlider slider)
Creates a change listener.
Parameters:
slider - a slider
Returns:
a change listener

createComponentListener

protected ComponentListener createComponentListener(JSlider slider)
Creates a composite listener.
Parameters:
slider - a slider
Returns:
a composite listener

createFocusListener

protected FocusListener createFocusListener(JSlider slider)
Creates a focus listener.
Parameters:
slider - a slider
Returns:
a focus listener

createScrollListener

protected BasicSliderUI.ScrollListener createScrollListener(JSlider slider)
Creates a scroll listener.
Parameters:
slider - a slider
Returns:
a scroll listener

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener(JSlider slider)
Creates a property change listener.
Parameters:
slider - a slider
Returns:
a property change listener

installListeners

protected void installListeners(JSlider slider)
Installs listeners.
Parameters:
slider - a slider

uninstallListeners

protected void uninstallListeners(JSlider slider)
Uninstalls listeners.
Parameters:
slider - a slider

installKeyboardActions

protected void installKeyboardActions(JSlider slider)
Installs keyboard actions.
Parameters:
slider - a slider

uninstallKeyboardActions

protected void uninstallKeyboardActions(JSlider slider)
Uninstalls keyboard actions.
Parameters:
slider - a slider

getBaseline

public int getBaseline(JComponent c, int width, int height)
Returns the baseline.
Overrides:
getBaseline in class ComponentUI
Parameters:
c - JComponent baseline is being requested for
width - the width to get the baseline for
height - the height to get the baseline for
Returns:
baseline or a value < 0 indicating there is no reasonable baseline
Throws:
NullPointerException - if c is null
IllegalArgumentException - if width or height is < 0
Since:
1.6
See Also:

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)
Returns an enum indicating how the baseline of the component changes as the size changes.
Overrides:
getBaselineResizeBehavior in class ComponentUI
Parameters:
c - JComponent to return baseline resize behavior for
Returns:
an enum indicating how the baseline changes as the component size changes
Throws:
NullPointerException - if c is null
Since:
1.6
See Also:

labelsHaveSameBaselines

protected boolean labelsHaveSameBaselines()
Returns true if all the labels from the label table have the same baseline.
Returns:
true if all the labels from the label table have the same baseline
Since:
1.6

getPreferredHorizontalSize

public Dimension getPreferredHorizontalSize()
Returns the preferred horizontal size.
Returns:
the preferred horizontal size

getPreferredVerticalSize

public Dimension getPreferredVerticalSize()
Returns the preferred vertical size.
Returns:
the preferred vertical size

getMinimumHorizontalSize

public Dimension getMinimumHorizontalSize()
Returns the minimum horizontal size.
Returns:
the minimum horizontal size

getMinimumVerticalSize

public Dimension getMinimumVerticalSize()
Returns the minimum vertical size.
Returns:
the minimum vertical size

getPreferredSize

public Dimension getPreferredSize(JComponent c)
Returns the preferred size.
Overrides:
getPreferredSize in class ComponentUI
Parameters:
c - a component
Returns:
the preferred size
See Also:

getMinimumSize

public Dimension getMinimumSize(JComponent c)
Returns the minimum size.
Overrides:
getMinimumSize in class ComponentUI
Parameters:
c - a component
Returns:
the minimum size
See Also:

getMaximumSize

public Dimension getMaximumSize(JComponent c)
Returns the maximum size.
Overrides:
getMaximumSize in class ComponentUI
Parameters:
c - a component
Returns:
the maximum size
See Also:

calculateGeometry

protected void calculateGeometry()
Calculates the geometry.

calculateFocusRect

protected void calculateFocusRect()
Calculates the focus rectangle.

calculateThumbSize

protected void calculateThumbSize()
Calculates the thumb size rectangle.

calculateContentRect

protected void calculateContentRect()
Calculates the content rectangle.

calculateThumbLocation

protected void calculateThumbLocation()
Calculates the thumb location.

calculateTrackBuffer

protected void calculateTrackBuffer()
Calculates the track buffer.

calculateTrackRect

protected void calculateTrackRect()
Calculates the track rectangle.

getTickLength

protected int getTickLength()
Gets the height of the tick area for horizontal sliders and the width of the tick area for vertical sliders. BasicSliderUI uses the returned value to determine the tick area rectangle. If you want to give your ticks some room, make this larger than you need and paint your ticks away from the sides in paintTicks().
Returns:
an integer representing the height of the tick area for horizontal sliders, and the width of the tick area for the vertical sliders

calculateTickRect

protected void calculateTickRect()
Calculates the tick rectangle.

calculateLabelRect

protected void calculateLabelRect()
Calculates the label rectangle.

getThumbSize

protected Dimension getThumbSize()
Returns the thumb size.
Returns:
the thumb size

getWidthOfWidestLabel

protected int getWidthOfWidestLabel()
Returns the width of the widest label.
Returns:
the width of the widest label

getHeightOfTallestLabel

protected int getHeightOfTallestLabel()
Returns the height of the tallest label.
Returns:
the height of the tallest label

getWidthOfHighValueLabel

protected int getWidthOfHighValueLabel()
Returns the width of the highest value label.
Returns:
the width of the highest value label

getWidthOfLowValueLabel

protected int getWidthOfLowValueLabel()
Returns the width of the lowest value label.
Returns:
the width of the lowest value label

getHeightOfHighValueLabel

protected int getHeightOfHighValueLabel()
Returns the height of the highest value label.
Returns:
the height of the highest value label

getHeightOfLowValueLabel

protected int getHeightOfLowValueLabel()
Returns the height of the lowest value label.
Returns:
the height of the lowest value label

drawInverted

protected boolean drawInverted()
Draws inverted.
Returns:
the inverted-ness

getHighestValue

protected Integer getHighestValue()
Returns the biggest value that has an entry in the label table.
Returns:
biggest value that has an entry in the label table, or null.
Since:
1.6

getLowestValue

protected Integer getLowestValue()
Returns the smallest value that has an entry in the label table.
Returns:
smallest value that has an entry in the label table, or null.
Since:
1.6

getLowestValueLabel

protected Component getLowestValueLabel()
Returns the label that corresponds to the highest slider value in the label table.
Returns:
the label that corresponds to the highest slider value in the label table
See Also:

getHighestValueLabel

protected Component getHighestValueLabel()
Returns the label that corresponds to the lowest slider value in the label table.
Returns:
the label that corresponds to the lowest slider value in the label table
See Also:

recalculateIfInsetsChanged

protected void recalculateIfInsetsChanged()
Recalculates if the insets have changed.

recalculateIfOrientationChanged

protected void recalculateIfOrientationChanged()
Recalculates if the orientation has changed.

paintFocus

public void paintFocus(Graphics g)
Paints focus.
Parameters:
g - the graphics

paintTrack

public void paintTrack(Graphics g)
Paints track.
Parameters:
g - the graphics

paintTicks

public void paintTicks(Graphics g)
Paints ticks.
Parameters:
g - the graphics

paintMinorTickForHorizSlider

protected void paintMinorTickForHorizSlider(Graphics g, Rectangle tickBounds, int x)
Paints minor tick for horizontal slider.
Parameters:
g - the graphics
tickBounds - the tick bounds
x - the x coordinate

paintMajorTickForHorizSlider

protected void paintMajorTickForHorizSlider(Graphics g, Rectangle tickBounds, int x)
Paints major tick for horizontal slider.
Parameters:
g - the graphics
tickBounds - the tick bounds
x - the x coordinate

paintMinorTickForVertSlider

protected void paintMinorTickForVertSlider(Graphics g, Rectangle tickBounds, int y)
Paints minor tick for vertical slider.
Parameters:
g - the graphics
tickBounds - the tick bounds
y - the y coordinate

paintMajorTickForVertSlider

protected void paintMajorTickForVertSlider(Graphics g, Rectangle tickBounds, int y)
Paints major tick for vertical slider.
Parameters:
g - the graphics
tickBounds - the tick bounds
y - the y coordinate

paintLabels

public void paintLabels(Graphics g)
Paints the labels.
Parameters:
g - the graphics

paintHorizontalLabel

protected void paintHorizontalLabel(Graphics g, int value, Component label)
Called for every label in the label table. Used to draw the labels for horizontal sliders. The graphics have been translated to labelRect.y already.
Parameters:
g - the graphics context in which to paint
value - the value of the slider
label - the component label in the label table that needs to be painted
See Also:

paintVerticalLabel

protected void paintVerticalLabel(Graphics g, int value, Component label)
Called for every label in the label table. Used to draw the labels for vertical sliders. The graphics have been translated to labelRect.x already.
Parameters:
g - the graphics context in which to paint
value - the value of the slider
label - the component label in the label table that needs to be painted
See Also:

paintThumb

public void paintThumb(Graphics g)
Paints the thumb.
Parameters:
g - the graphics

setThumbLocation

public void setThumbLocation(int x, int y)
Sets the thumb location.
Parameters:
x - the x coordinate
y - the y coordinate

scrollByBlock

public void scrollByBlock(int direction)
Scrolls by block.
Parameters:
direction - the direction

scrollByUnit

public void scrollByUnit(int direction)
Scrolls by unit.
Parameters:
direction - the direction

scrollDueToClickInTrack

protected void scrollDueToClickInTrack(int dir)
This function is called when a mousePressed was detected in the track, not in the thumb. The default behavior is to scroll by block. You can override this method to stop it from scrolling or to add additional behavior.
Parameters:
dir - the direction and number of blocks to scroll

xPositionForValue

protected int xPositionForValue(int value)
Returns the x position for a value.
Parameters:
value - the value
Returns:
the x position for a value

yPositionForValue

protected int yPositionForValue(int value)
Returns the y position for a value.
Parameters:
value - the value
Returns:
the y position for a value

yPositionForValue

protected int yPositionForValue(int value, int trackY, int trackHeight)
Returns the y location for the specified value. No checking is done on the arguments. In particular if trackHeight is negative undefined results may occur.
Parameters:
value - the slider value to get the location for
trackY - y-origin of the track
trackHeight - the height of the track
Returns:
the y location for the specified value of the slider
Since:
1.6

valueForYPosition

public int valueForYPosition(int yPos)
Returns the value at the y position. If yPos is beyond the track at the bottom or the top, this method sets the value to either the minimum or maximum value of the slider, depending on if the slider is inverted or not.
Parameters:
yPos - the location of the slider along the y axis
Returns:
the value at the y position

valueForXPosition

public int valueForXPosition(int xPos)
Returns the value at the x position. If xPos is beyond the track at the left or the right, this method sets the value to either the minimum or maximum value of the slider, depending on if the slider is inverted or not.
Parameters:
xPos - the location of the slider along the x axis
Returns:
the value of the x position

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/plaf/basic/BasicSliderUI.html