BasicSliderUI (Java 2 Platform SE v1.4.1_"07")

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## javax.swing.plaf.basic
Class BasicSliderUI

    java.lang.Object
      |
      +--javax.swing.plaf.ComponentUI
            |
            +--javax.swing.plaf.SliderUI
                  |
                  +--javax.swing.plaf.basic.BasicSliderUI

Direct Known Subclasses:
  MetalSliderUI

public class BasicSliderUI
extends SliderUI

A Basic L&F implementation of SliderUI.

Nested Class Summary
`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`
`class` | `BasicSliderUI.ScrollListener` Scroll-event listener.
`class` | `BasicSliderUI.TrackListener` Track mouse movements.

Field Summary
`protected ChangeListener` | `changeListener`
`protected ComponentListener` | `componentListener`
`protected Rectangle` | `contentRect`
`protected Insets` | `focusInsets`
`protected FocusListener` | `focusListener`
`protected Rectangle` | `focusRect`
`protected Insets` | `insetCache`
`protected Rectangle` | `labelRect`
`protected boolean` | `leftToRightCache`
`static int` | `MAX_SCROLL`
`static int` | `MIN_SCROLL`
`static int` | `NEGATIVE_SCROLL`
`static int` | `POSITIVE_SCROLL`
`protected PropertyChangeListener` | `propertyChangeListener`
`protected BasicSliderUI.ScrollListener` | `scrollListener`
`protected Timer` | `scrollTimer`
`protected JSlider` | `slider`
`protected Rectangle` | `thumbRect`
`protected Rectangle` | `tickRect`
`protected int` | `trackBuffer`
`protected BasicSliderUI.TrackListener` | `trackListener`
`protected Rectangle` | `trackRect`

Constructor Summary
`BasicSliderUI(JSlider b)`

Method Summary
`protected void` | `calculateContentRect()`
`protected void` | `calculateFocusRect()`
`protected void` | `calculateGeometry()`
`protected void` | `calculateLabelRect()`
`protected void` | `calculateThumbLocation()`
`protected void` | `calculateThumbSize()`
`protected void` | `calculateTickRect()`
`protected void` | `calculateTrackBuffer()`
`protected void` | `calculateTrackRect()`
`protected ChangeListener` | `createChangeListener(JSlider slider)`
`protected ComponentListener` | `createComponentListener(JSlider slider)`
`protected FocusListener` | `createFocusListener(JSlider slider)`
`protected PropertyChangeListener` | `createPropertyChangeListener(JSlider slider)`
`protected BasicSliderUI.ScrollListener` | `createScrollListener(JSlider slider)`
`protected BasicSliderUI.TrackListener` | `createTrackListener(JSlider slider)`
`static ComponentUI` | `createUI(JComponent b)` Returns an instance of the UI delegate for the specified component.
`protected boolean` | `drawInverted()`
`protected Color` | `getFocusColor()`
`protected int` | `getHeightOfHighValueLabel()`
`protected int` | `getHeightOfLowValueLabel()`
`protected int` | `getHeightOfTallestLabel()`
`protected Component` | `getHighestValueLabel()` Returns the label that corresponds to the lowest slider value in the label table.
`protected Color` | `getHighlightColor()`
`protected Component` | `getLowestValueLabel()` Returns the label that corresponds to the highest slider value in the label table.
`Dimension` | `getMaximumSize(JComponent c)` Returns the specified component's maximum size appropriate for the look and feel.
`Dimension` | `getMinimumHorizontalSize()`
`Dimension` | `getMinimumSize(JComponent c)` Returns the specified component's minimum size appropriate for the look and feel.
`Dimension` | `getMinimumVerticalSize()`
`Dimension` | `getPreferredHorizontalSize()`
`Dimension` | `getPreferredSize(JComponent c)` Returns the specified component's preferred size appropriate for the look and feel.
`Dimension` | `getPreferredVerticalSize()`
`protected Color` | `getShadowColor()`
`protected Dimension` | `getThumbSize()`
`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()`
`protected int` | `getWidthOfLowValueLabel()`
`protected int` | `getWidthOfWidestLabel()`
`protected void` | `installDefaults(JSlider slider)`
`protected void` | `installKeyboardActions(JSlider slider)`
`protected void` | `installListeners(JSlider slider)`
`void` | `installUI(JComponent c)` Configures the specified component appropriate for the look and feel.
`void` | `paint(Graphics g, JComponent c)` Paints the specified component appropriate for the look and feel.
`void` | `paintFocus(Graphics g)`
`protected void` | `paintHorizontalLabel(Graphics g, int value, Component label)` Called for every label in the label table.
`void` | `paintLabels(Graphics g)`
`protected void` | `paintMajorTickForHorizSlider(Graphics g, Rectangle tickBounds, int x)`
`protected void` | `paintMajorTickForVertSlider(Graphics g, Rectangle tickBounds, int y)`
`protected void` | `paintMinorTickForHorizSlider(Graphics g, Rectangle tickBounds, int x)`
`protected void` | `paintMinorTickForVertSlider(Graphics g, Rectangle tickBounds, int y)`
`void` | `paintThumb(Graphics g)`
`void` | `paintTicks(Graphics g)`
`void` | `paintTrack(Graphics g)`
`protected void` | `paintVerticalLabel(Graphics g, int value, Component label)` Called for every label in the label table.
`protected void` | `recalculateIfInsetsChanged()`
`protected void` | `recalculateIfOrientationChanged()`
`void` | `scrollByBlock(int direction)`
`void` | `scrollByUnit(int direction)`
`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)`
`protected void` | `uninstallKeyboardActions(JSlider slider)`
`protected void` | `uninstallListeners(JSlider slider)`
`void` | `uninstallUI(JComponent c)` Reverses configuration which was done on the specified component during `installUI`.
`int` | `valueForXPosition(int xPos)` Returns a value give an x position.
`int` | `valueForYPosition(int yPos)` Returns a value give a y position.
`protected int` | `xPositionForValue(int value)`
`protected int` | `yPositionForValue(int value)`

Methods inherited from class javax.swing.plaf.ComponentUI
`contains, getAccessibleChild, getAccessibleChildrenCount, update`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### POSITIVE_SCROLL

    public static final int POSITIVE_SCROLL

See Also:
  Constant Field Values

### NEGATIVE_SCROLL

    public static final int NEGATIVE_SCROLL

See Also:
  Constant Field Values

### MIN_SCROLL

    public static final int MIN_SCROLL

See Also:
  Constant Field Values

### MAX_SCROLL

    public static final int MAX_SCROLL

See Also:
  Constant Field Values

### scrollTimer

    protected Timer scrollTimer

### slider

    protected JSlider slider

### focusInsets

    protected Insets focusInsets

### insetCache

    protected Insets insetCache

### leftToRightCache

    protected boolean leftToRightCache

### focusRect

    protected Rectangle focusRect

### contentRect

    protected Rectangle contentRect

### labelRect

    protected Rectangle labelRect

### tickRect

    protected Rectangle tickRect

### trackRect

    protected Rectangle trackRect

### thumbRect

    protected Rectangle thumbRect

### trackBuffer

    protected int trackBuffer

### trackListener

    protected BasicSliderUI.TrackListener trackListener

### changeListener

    protected ChangeListener changeListener

### componentListener

    protected ComponentListener componentListener

### focusListener

    protected FocusListener focusListener

### scrollListener

    protected BasicSliderUI.ScrollListener scrollListener

### propertyChangeListener

    protected PropertyChangeListener propertyChangeListener

Constructor Detail

### BasicSliderUI

    public BasicSliderUI(JSlider b)

Method Detail

### getShadowColor

    protected Color getShadowColor()

### getHighlightColor

    protected Color getHighlightColor()

### getFocusColor

    protected Color getFocusColor()

### createUI

    public static ComponentUI createUI(JComponent b)

  Description copied from class: `ComponentUI`
  Returns an instance of the UI delegate for the specified component. Each subclass must provide its own static `createUI` method that returns an instance of that UI delegate subclass. If the UI delegate subclass is stateless, it may return an instance that is shared by multiple components. If the UI delegate is stateful, then it should return a new instance per component. The default implementation of this method throws an error, as it should never be invoked.

### installUI

    public void installUI(JComponent c)

  Description copied from class: `ComponentUI`
  Configures the specified component appropriate for the look and feel. This method is invoked when the `ComponentUI` instance is being installed as the UI delegate on the specified component. This method should completely configure the component for the look and feel, including the following:
  1. Install any default property values for color, fonts, borders, icons, opacity, etc. on the component. Whenever possible, property values initialized by the client program should not be overridden.
  2. Install a `LayoutManager` on the component if necessary.
  3. Create/add any required sub-components to the component.
  4. Create/install event listeners on the component.
  5. Create/install a `PropertyChangeListener` on the component in order to detect and respond to component property changes appropriately.
  6. Install keyboard UI (mnemonics, traversal, etc.) on the component.
  7. Initialize any appropriate instance data.

  Overrides:
    `installUI` in class `ComponentUI`
  Parameters:
    `c` - the component where this UI delegate is being installed
  See Also:
    `ComponentUI.uninstallUI(javax.swing.JComponent)`, `JComponent.setUI(javax.swing.plaf.ComponentUI)`, `JComponent.updateUI()`

### uninstallUI

    public void uninstallUI(JComponent c)

  Description copied from class: `ComponentUI`
  Reverses configuration which was done on the specified component during `installUI`. This method is invoked when this `UIComponent` instance is being removed as the UI delegate for the specified component. This method should undo the configuration performed in `installUI`, being careful to leave the `JComponent` instance in a clean state (no extraneous listeners, look-and-feel-specific property objects, etc.). This should include the following:
  1. Remove any UI-set borders from the component.
  2. Remove any UI-set layout managers on the component.
  3. Remove any UI-added sub-components from the component.
  4. Remove any UI-added event/property listeners from the component.
  5. Remove any UI-installed keyboard UI from the component.
  6. Nullify any allocated instance data objects to allow for GC.

  Overrides:
    `uninstallUI` in class `ComponentUI`
  Parameters:
    `c` - the component from which this UI delegate is being removed; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  See Also:
    `ComponentUI.installUI(javax.swing.JComponent)`, `JComponent.updateUI()`

### installDefaults

    protected void installDefaults(JSlider slider)

### createTrackListener

    protected BasicSliderUI.TrackListener createTrackListener(JSlider slider)

### createChangeListener

    protected ChangeListener createChangeListener(JSlider slider)

### createComponentListener

    protected ComponentListener createComponentListener(JSlider slider)

### createFocusListener

    protected FocusListener createFocusListener(JSlider slider)

### createScrollListener

    protected BasicSliderUI.ScrollListener createScrollListener(JSlider slider)

### createPropertyChangeListener

    protected PropertyChangeListener createPropertyChangeListener(JSlider slider)

### installListeners

    protected void installListeners(JSlider slider)

### uninstallListeners

    protected void uninstallListeners(JSlider slider)

### installKeyboardActions

    protected void installKeyboardActions(JSlider slider)

### uninstallKeyboardActions

    protected void uninstallKeyboardActions(JSlider slider)

### getPreferredHorizontalSize

    public Dimension getPreferredHorizontalSize()

### getPreferredVerticalSize

    public Dimension getPreferredVerticalSize()

### getMinimumHorizontalSize

    public Dimension getMinimumHorizontalSize()

### getMinimumVerticalSize

    public Dimension getMinimumVerticalSize()

### getPreferredSize

    public Dimension getPreferredSize(JComponent c)

  Description copied from class: `ComponentUI`
  Returns the specified component's preferred size appropriate for the look and feel. If `null` is returned, the preferred size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method returns `null`.

  Overrides:
    `getPreferredSize` in class `ComponentUI`
  Parameters:
    `c` - the component whose preferred size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  See Also:
    `JComponent.getPreferredSize()`, `LayoutManager.preferredLayoutSize(java.awt.Container)`

### getMinimumSize

    public Dimension getMinimumSize(JComponent c)

  Description copied from class: `ComponentUI`
  Returns the specified component's minimum size appropriate for the look and feel. If `null` is returned, the minimum size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method invokes `getPreferredSize` and returns that value.

  Overrides:
    `getMinimumSize` in class `ComponentUI`
  Parameters:
    `c` - the component whose minimum size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  Returns:
    a `Dimension` object or `null`
  See Also:
    `JComponent.getMinimumSize()`, `LayoutManager.minimumLayoutSize(java.awt.Container)`, `ComponentUI.getPreferredSize(javax.swing.JComponent)`

### getMaximumSize

    public Dimension getMaximumSize(JComponent c)

  Description copied from class: `ComponentUI`
  Returns the specified component's maximum size appropriate for the look and feel. If `null` is returned, the maximum size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method invokes `getPreferredSize` and returns that value.

  Overrides:
    `getMaximumSize` in class `ComponentUI`
  Parameters:
    `c` - the component whose maximum size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  Returns:
    a `Dimension` object or `null`
  See Also:
    `JComponent.getMaximumSize()`, `LayoutManager2.maximumLayoutSize(java.awt.Container)`

### calculateGeometry

    protected void calculateGeometry()

### calculateFocusRect

    protected void calculateFocusRect()

### calculateThumbSize

    protected void calculateThumbSize()

### calculateContentRect

    protected void calculateContentRect()

### calculateThumbLocation

    protected void calculateThumbLocation()

### calculateTrackBuffer

    protected void calculateTrackBuffer()

### calculateTrackRect

    protected void calculateTrackRect()

### 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().

### calculateTickRect

    protected void calculateTickRect()

### calculateLabelRect

    protected void calculateLabelRect()

### getThumbSize

    protected Dimension getThumbSize()

### getWidthOfWidestLabel

    protected int getWidthOfWidestLabel()

### getHeightOfTallestLabel

    protected int getHeightOfTallestLabel()

### getWidthOfHighValueLabel

    protected int getWidthOfHighValueLabel()

### getWidthOfLowValueLabel

    protected int getWidthOfLowValueLabel()

### getHeightOfHighValueLabel

    protected int getHeightOfHighValueLabel()

### getHeightOfLowValueLabel

    protected int getHeightOfLowValueLabel()

### drawInverted

    protected boolean drawInverted()

### getLowestValueLabel

    protected Component getLowestValueLabel()

  Returns the label that corresponds to the highest slider value in the label table.

  See Also:
    `JSlider.setLabelTable(java.util.Dictionary)`

### getHighestValueLabel

    protected Component getHighestValueLabel()

  Returns the label that corresponds to the lowest slider value in the label table.

  See Also:
    `JSlider.setLabelTable(java.util.Dictionary)`

### paint

    public void paint(Graphics g,
                      JComponent c)

  Description copied from class: `ComponentUI`
  Paints the specified component appropriate for the look and feel. This method is invoked from the `ComponentUI.update` method when the specified component is being painted. Subclasses should override this method and use the specified `Graphics` object to render the content of the component.

  Overrides:
    `paint` in class `ComponentUI`
  Parameters:
    `g` - the `Graphics` context in which to paint
    `c` - the component being painted; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  See Also:
    `ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)`

### recalculateIfInsetsChanged

    protected void recalculateIfInsetsChanged()

### recalculateIfOrientationChanged

    protected void recalculateIfOrientationChanged()

### paintFocus

    public void paintFocus(Graphics g)

### paintTrack

    public void paintTrack(Graphics g)

### paintTicks

    public void paintTicks(Graphics g)

### paintMinorTickForHorizSlider

    protected void paintMinorTickForHorizSlider(Graphics g,
                                                Rectangle tickBounds,
                                                int x)

### paintMajorTickForHorizSlider

    protected void paintMajorTickForHorizSlider(Graphics g,
                                                Rectangle tickBounds,
                                                int x)

### paintMinorTickForVertSlider

    protected void paintMinorTickForVertSlider(Graphics g,
                                               Rectangle tickBounds,
                                               int y)

### paintMajorTickForVertSlider

    protected void paintMajorTickForVertSlider(Graphics g,
                                               Rectangle tickBounds,
                                               int y)

### paintLabels

    public void paintLabels(Graphics g)

### 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.

  See Also:
    `JSlider.setLabelTable(java.util.Dictionary)`

### 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.

  See Also:
    `JSlider.setLabelTable(java.util.Dictionary)`

### paintThumb

    public void paintThumb(Graphics g)

### setThumbLocation

    public void setThumbLocation(int x,
                                 int y)

### scrollByBlock

    public void scrollByBlock(int direction)

### scrollByUnit

    public void scrollByUnit(int 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.

### xPositionForValue

    protected int xPositionForValue(int value)

### yPositionForValue

    protected int yPositionForValue(int value)

### valueForYPosition

    public int valueForYPosition(int yPos)

  Returns a value give a y position. If yPos is past the track at the top or the bottom it will set the value to the min or max of the slider, depending if the slider is inverted or not.

### valueForXPosition

    public int valueForXPosition(int xPos)

  Returns a value give an x position. If xPos is past the track at the left or the right it will set the value to the min or max of the slider, depending if the slider is inverted or not.

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

JavaTM 2 Platform
Std. Ed. v1.4.1_"07"

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.