java.lang.Object
javax.swing.plaf.ComponentUI
javax.swing.plaf.ScrollBarUI
javax.swing.plaf.basic.BasicScrollBarUI
- All Implemented Interfaces:
- LayoutManager,- SwingConstants
- Direct Known Subclasses:
- MetalScrollBarUI,- SynthScrollBarUI
Implementation of ScrollBarUI for the Basic Look and Feel
- 
Nested Class SummaryNested ClassesModifier and TypeClassDescriptionprotected classListener for cursor keys.protected classA listener to listen for model changes.classProperty change handlerprotected classListener for scrolling events initiated in theScrollPane.protected classTrack mouse drags.
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected BasicScrollBarUI.ArrowButtonListenerButton listenerprotected JButtonDecrement buttonprotected static final intDecrease highlightprotected intDistance between the decrement button and the track.protected JButtonIncrement buttonprotected static final intIncrease highlightprotected intDistance between the increment button and the track.protected booleanDraggingprotected DimensionMaximum thumb sizeprotected DimensionMinimum thumb sizeprotected BasicScrollBarUI.ModelListenerModel listenerprotected static final intNo highlightprotected PropertyChangeListenerProperty change listenerprotected JScrollBarScrollbarprotected intHint as to what width (when vertical) or height (when horizontal) should be.protected BasicScrollBarUI.ScrollListenerScroll listenerprotected TimerScroll timerprotected ColorThumb colorprotected ColorThumb dark shadow colorprotected ColorThumb highlight colorprotected ColorThumb light shadow colorprotected RectangleThumb rectangleprotected ColorTrack colorprotected intTrack highlightprotected ColorTrack highlight colorprotected BasicScrollBarUI.TrackListenerTrack listenerprotected RectangleTrack rectangleFields declared in interface javax.swing.SwingConstantsBOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidaddLayoutComponent(String name, Component child) If the layout manager uses a per-component string, adds the componentcompto the layout, associating it with the string specified byname.protected voidConfigures the scroll bar colors.protected BasicScrollBarUI.ArrowButtonListenerCreates an arrow button listener.protected JButtoncreateDecreaseButton(int orientation) Creates a decrease button.protected JButtoncreateIncreaseButton(int orientation) Creates an increase button.protected BasicScrollBarUI.ModelListenerCreates a model listener.protected PropertyChangeListenerCreates a property change listener.protected BasicScrollBarUI.ScrollListenerCreates a scroll listener.protected BasicScrollBarUI.TrackListenerCreates a track listener.static ComponentUICreates the UI.Returns the specified component's maximum size appropriate for the look and feel.protected DimensionReturns the largest acceptable size for the thumb.protected DimensionReturns the smallest acceptable size for the thumb.A vertical scrollbar's preferred width is the maximum of preferred widths of the (nonnull) increment/decrement buttons, and the minimum width of the thumb.booleanIndicates whether the user can absolutely position the thumb with a mouse gesture (usually the middle mouse button).protected RectangleReturn the current size/location of the thumb.protected RectangleReturns the current bounds of the track, i.e. the space in between the increment and decrement buttons, less the insets.protected voidInstalls the components.protected voidInstalls the defaults.protected voidInstalls the keyboard actions.protected voidInstalls the listeners.voidInstalls the UI.booleanReturns true if the mouse is currently over the thumb.voidlayoutContainer(Container scrollbarContainer) Lays out the specified container.protected voidLays out a horizontal scroll bar.protected voidLays out a vertical scroll bar.minimumLayoutSize(Container scrollbarContainer) Calculates the minimum size dimensions for the specified container, given the components it contains.protected voidPaints the decrease highlight.protected voidPaints the increase highlight.protected voidpaintThumb(Graphics g, JComponent c, Rectangle thumbBounds) Paints the thumb.protected voidpaintTrack(Graphics g, JComponent c, Rectangle trackBounds) Paints the track.preferredLayoutSize(Container scrollbarContainer) Calculates the preferred size dimensions for the specified container, given the components it contains.voidremoveLayoutComponent(Component child) Removes the specified component from the layout.protected voidscrollByBlock(int direction) Scrolls by block.protected voidscrollByUnit(int direction) Scrolls by unit.protected voidsetThumbBounds(int x, int y, int width, int height) Set the bounds of the thumb and force a repaint that includes the old thumbBounds and the new one.protected voidsetThumbRollover(boolean active) Sets whether or not the mouse is currently over the thumb.protected voidUninstalls the components.protected voidUninstalls the defaults.protected voidUninstalls the keyboard actions.protected voidUninstall the listeners.voidUninstalls the UI.Methods declared in class javax.swing.plaf.ComponentUIcontains, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMinimumSize, paint, update
- 
Field Details- 
minimumThumbSizeMinimum thumb size
- 
maximumThumbSizeMaximum thumb size
- 
thumbHighlightColorThumb highlight color
- 
thumbLightShadowColorThumb light shadow color
- 
thumbDarkShadowColorThumb dark shadow color
- 
thumbColorThumb color
- 
trackColorTrack color
- 
trackHighlightColorTrack highlight color
- 
scrollbarScrollbar
- 
incrButtonIncrement button
- 
decrButtonDecrement button
- 
isDraggingprotected boolean isDraggingDragging
- 
trackListenerTrack listener
- 
buttonListenerButton listener
- 
modelListenerModel listener
- 
thumbRectThumb rectangle
- 
trackRectTrack rectangle
- 
trackHighlightprotected int trackHighlightTrack highlight
- 
NO_HIGHLIGHTprotected static final int NO_HIGHLIGHTNo highlight- See Also:
 
- 
DECREASE_HIGHLIGHTprotected static final int DECREASE_HIGHLIGHTDecrease highlight- See Also:
 
- 
INCREASE_HIGHLIGHTprotected static final int INCREASE_HIGHLIGHTIncrease highlight- See Also:
 
- 
scrollListenerScroll listener
- 
propertyChangeListenerProperty change listener
- 
scrollTimerScroll timer
- 
scrollBarWidthprotected int scrollBarWidthHint as to what width (when vertical) or height (when horizontal) should be.- Since:
- 1.7
 
- 
incrGapprotected int incrGapDistance between the increment button and the track. This may be a negative number. If negative, then an overlap between the button and track will occur, which is useful for shaped buttons.- Since:
- 1.7
 
- 
decrGapprotected int decrGapDistance between the decrement button and the track. This may be a negative number. If negative, then an overlap between the button and track will occur, which is useful for shaped buttons.- Since:
- 1.7
 
 
- 
- 
Constructor Details- 
BasicScrollBarUIpublic BasicScrollBarUI()Constructs aBasicScrollBarUI.
 
- 
- 
Method Details- 
createUICreates the UI.- Parameters:
- c- the component
- Returns:
- the UI
 
- 
configureScrollBarColorsprotected void configureScrollBarColors()Configures the scroll bar colors.
- 
installUIInstalls the UI.- Overrides:
- installUIin class- ComponentUI
- Parameters:
- c- the component
- See Also:
 
- 
uninstallUIUninstalls the UI.- Overrides:
- uninstallUIin class- ComponentUI
- Parameters:
- c- the component
- See Also:
 
- 
installDefaultsprotected void installDefaults()Installs the defaults.
- 
installComponentsprotected void installComponents()Installs the components.
- 
uninstallComponentsprotected void uninstallComponents()Uninstalls the components.
- 
installListenersprotected void installListeners()Installs the listeners.
- 
installKeyboardActionsprotected void installKeyboardActions()Installs the keyboard actions.
- 
uninstallKeyboardActionsprotected void uninstallKeyboardActions()Uninstalls the keyboard actions.
- 
uninstallListenersprotected void uninstallListeners()Uninstall the listeners.
- 
uninstallDefaultsprotected void uninstallDefaults()Uninstalls the defaults.
- 
createTrackListenerCreates a track listener.- Returns:
- a track listener
 
- 
createArrowButtonListenerCreates an arrow button listener.- Returns:
- an arrow button listener
 
- 
createModelListenerCreates a model listener.- Returns:
- a model listener
 
- 
createScrollListenerCreates a scroll listener.- Returns:
- a scroll listener
 
- 
createPropertyChangeListenerCreates a property change listener.- Returns:
- a property change listener
 
- 
setThumbRolloverprotected void setThumbRollover(boolean active) Sets whether or not the mouse is currently over the thumb.- Parameters:
- active- True indicates the thumb is currently active.
- Since:
- 1.5
 
- 
isThumbRolloverpublic boolean isThumbRollover()Returns true if the mouse is currently over the thumb.- Returns:
- true if the thumb is currently active
- Since:
- 1.5
 
- 
getPreferredSizeA vertical scrollbar's preferred width is the maximum of preferred widths of the (nonnull) increment/decrement buttons, and the minimum width of the thumb. The preferred height is the sum of the preferred heights of the same parts. The basis for the preferred size of a horizontal scrollbar is similar.The preferredSizeis only computed once, subsequent calls to this method just return a cached size.- Overrides:
- getPreferredSizein class- ComponentUI
- Parameters:
- c- the- JScrollBarthat's delegating this method to us
- Returns:
- the preferred size of a Basic JScrollBar
- See Also:
 
- 
getMaximumSizeDescription copied from class:ComponentUIReturns the specified component's maximum size appropriate for the look and feel. Ifnullis 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 invokesgetPreferredSizeand returns that value.- Overrides:
- getMaximumSizein class- ComponentUI
- Parameters:
- c- The JScrollBar that's delegating this method to us.
- Returns:
- new Dimension(Integer.MAX_VALUE, Integer.MAX_VALUE);
- See Also:
 
- 
createDecreaseButtonCreates a decrease button.- Parameters:
- orientation- the orientation
- Returns:
- a decrease button
 
- 
createIncreaseButtonCreates an increase button.- Parameters:
- orientation- the orientation
- Returns:
- an increase button
 
- 
paintDecreaseHighlightPaints the decrease highlight.- Parameters:
- g- the graphics
 
- 
paintIncreaseHighlightPaints the increase highlight.- Parameters:
- g- the graphics
 
- 
paintTrackPaints the track.- Parameters:
- g- the graphics
- c- the component
- trackBounds- the track bounds
 
- 
paintThumbPaints the thumb.- Parameters:
- g- the graphics
- c- the component
- thumbBounds- the thumb bounds
 
- 
getMinimumThumbSizeReturns the smallest acceptable size for the thumb. If the scrollbar becomes so small that this size isn't available, the thumb will be hidden.Warning : the value returned by this method should not be be modified, it's a shared static constant. - Returns:
- The smallest acceptable size for the thumb.
- See Also:
 
- 
getMaximumThumbSizeReturns the largest acceptable size for the thumb. To create a fixed size thumb one make this method andgetMinimumThumbSizereturn the same value.Warning : the value returned by this method should not be be modified, it's a shared static constant. - Returns:
- The largest acceptable size for the thumb.
- See Also:
 
- 
addLayoutComponentDescription copied from interface:LayoutManagerIf the layout manager uses a per-component string, adds the componentcompto the layout, associating it with the string specified byname.- Specified by:
- addLayoutComponentin interface- LayoutManager
- Parameters:
- name- the string to be associated with the component
- child- the component to be added
 
- 
removeLayoutComponentDescription copied from interface:LayoutManagerRemoves the specified component from the layout.- Specified by:
- removeLayoutComponentin interface- LayoutManager
- Parameters:
- child- the component to be removed
 
- 
preferredLayoutSizeDescription copied from interface:LayoutManagerCalculates the preferred size dimensions for the specified container, given the components it contains.- Specified by:
- preferredLayoutSizein interface- LayoutManager
- Parameters:
- scrollbarContainer- the container to be laid out
- Returns:
- the preferred dimension for the container
- See Also:
 
- 
minimumLayoutSizeDescription copied from interface:LayoutManagerCalculates the minimum size dimensions for the specified container, given the components it contains.- Specified by:
- minimumLayoutSizein interface- LayoutManager
- Parameters:
- scrollbarContainer- the component to be laid out
- Returns:
- the minimum dimension for the container
- See Also:
 
- 
layoutVScrollbarLays out a vertical scroll bar.- Parameters:
- sb- the scroll bar
 
- 
layoutHScrollbarLays out a horizontal scroll bar.- Parameters:
- sb- the scroll bar
 
- 
layoutContainerDescription copied from interface:LayoutManagerLays out the specified container.- Specified by:
- layoutContainerin interface- LayoutManager
- Parameters:
- scrollbarContainer- the container to be laid out
 
- 
setThumbBoundsprotected void setThumbBounds(int x, int y, int width, int height) Set the bounds of the thumb and force a repaint that includes the old thumbBounds and the new one.- Parameters:
- x- set the x location of the thumb
- y- set the y location of the thumb
- width- set the width of the thumb
- height- set the height of the thumb
- See Also:
 
- 
getThumbBoundsReturn the current size/location of the thumb.Warning : the value returned by this method should not be be modified, it's a reference to the actual rectangle, not a copy. - Returns:
- The current size/location of the thumb.
- See Also:
 
- 
getTrackBoundsReturns the current bounds of the track, i.e. the space in between the increment and decrement buttons, less the insets. The value returned by this method is updated each time the scrollbar is laid out (validated).Warning : the value returned by this method should not be be modified, it's a reference to the actual rectangle, not a copy. - Returns:
- the current bounds of the scrollbar track
- See Also:
 
- 
scrollByBlockprotected void scrollByBlock(int direction) Scrolls by block.- Parameters:
- direction- the direction to scroll
 
- 
scrollByUnitprotected void scrollByUnit(int direction) Scrolls by unit.- Parameters:
- direction- the direction to scroll
 
- 
getSupportsAbsolutePositioningpublic boolean getSupportsAbsolutePositioning()Indicates whether the user can absolutely position the thumb with a mouse gesture (usually the middle mouse button).- Returns:
- true if a mouse gesture can absolutely position the thumb
- Since:
- 1.5
 
 
-