BasicScrollBarUI (Java 2 Platform SE 5.0) (original) (raw)

javax.swing.plaf.basic

Class BasicScrollBarUI

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

public class BasicScrollBarUI

extends ScrollBarUI

implements LayoutManager, SwingConstants

Implementation of ScrollBarUI for the Basic Look and Feel

minimumThumbSize

protected Dimension minimumThumbSize

maximumThumbSize

protected Dimension maximumThumbSize

thumbHighlightColor

protected Color thumbHighlightColor

thumbLightShadowColor

protected Color thumbLightShadowColor

thumbDarkShadowColor

protected Color thumbDarkShadowColor

thumbColor

protected Color thumbColor

trackColor

protected Color trackColor

trackHighlightColor

protected Color trackHighlightColor

scrollbar

protected JScrollBar scrollbar

incrButton

protected JButton incrButton

decrButton

protected JButton decrButton

isDragging

protected boolean isDragging

trackListener

protected BasicScrollBarUI.TrackListener trackListener

buttonListener

protected BasicScrollBarUI.ArrowButtonListener buttonListener

modelListener

protected BasicScrollBarUI.ModelListener modelListener

thumbRect

protected Rectangle thumbRect

trackRect

protected Rectangle trackRect

trackHighlight

protected int trackHighlight

NO_HIGHLIGHT

protected static final int NO_HIGHLIGHT

See Also:

Constant Field Values

DECREASE_HIGHLIGHT

protected static final int DECREASE_HIGHLIGHT

See Also:

Constant Field Values

INCREASE_HIGHLIGHT

protected static final int INCREASE_HIGHLIGHT

See Also:

Constant Field Values

scrollListener

protected BasicScrollBarUI.ScrollListener scrollListener

propertyChangeListener

protected PropertyChangeListener propertyChangeListener

scrollTimer

protected Timer scrollTimer

BasicScrollBarUI

public BasicScrollBarUI()

createUI

public static ComponentUI createUI(JComponent c)

configureScrollBarColors

protected void configureScrollBarColors()

installUI

public void installUI(JComponent c)

Description copied from class: [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html#installUI%28javax.swing.JComponent%29)

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](../../../../javax/swing/plaf/ComponentUI.html#installUI%28javax.swing.JComponent%29) in class [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html "class in javax.swing.plaf")

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](../../../../javax/swing/plaf/ComponentUI.html#uninstallUI%28javax.swing.JComponent%29)

Reverses configuration which was done on the specified component duringinstallUI. 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](../../../../javax/swing/plaf/ComponentUI.html#uninstallUI%28javax.swing.JComponent%29) in class [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html "class in javax.swing.plaf")

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

installComponents

protected void installComponents()

uninstallComponents

protected void uninstallComponents()

installListeners

protected void installListeners()

installKeyboardActions

protected void installKeyboardActions()

uninstallKeyboardActions

protected void uninstallKeyboardActions()

uninstallListeners

protected void uninstallListeners()

uninstallDefaults

protected void uninstallDefaults()

createTrackListener

protected BasicScrollBarUI.TrackListener createTrackListener()

createArrowButtonListener

protected BasicScrollBarUI.ArrowButtonListener createArrowButtonListener()

createModelListener

protected BasicScrollBarUI.ModelListener createModelListener()

createScrollListener

protected BasicScrollBarUI.ScrollListener createScrollListener()

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()

setThumbRollover

protected 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

isThumbRollover

public boolean isThumbRollover()

Returns true if the mouse is currently over the thumb.

Returns:

true if the thumb is currently active

Since:

1.5

paint

public void paint(Graphics g, JComponent c)

Description copied from class: [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html#paint%28java.awt.Graphics, javax.swing.JComponent%29)

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](../../../../javax/swing/plaf/ComponentUI.html#paint%28java.awt.Graphics, javax.swing.JComponent%29) in class [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html "class in javax.swing.plaf")

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)](../../../../javax/swing/plaf/ComponentUI.html#update%28java.awt.Graphics, javax.swing.JComponent%29)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

A vertical scrollbar's preferred width is the maximum of preferred widths of the (non null) 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 preferredSize is only computed once, subsequent calls to this method just return a cached size.

Overrides:

[getPreferredSize](../../../../javax/swing/plaf/ComponentUI.html#getPreferredSize%28javax.swing.JComponent%29) in class [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html "class in javax.swing.plaf")

Parameters:

c - the JScrollBar that's delegating this method to us

Returns:

the preferred size of a Basic JScrollBar

See Also:

getMaximumSize(javax.swing.JComponent), ComponentUI.getMinimumSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

Description copied from class: [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html#getMaximumSize%28javax.swing.JComponent%29)

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](../../../../javax/swing/plaf/ComponentUI.html#getMaximumSize%28javax.swing.JComponent%29) in class [ComponentUI](../../../../javax/swing/plaf/ComponentUI.html "class in javax.swing.plaf")

Parameters:

c - The JScrollBar that's delegating this method to us.

Returns:

new Dimension(Integer.MAX_VALUE, Integer.MAX_VALUE);

See Also:

ComponentUI.getMinimumSize(javax.swing.JComponent), getPreferredSize(javax.swing.JComponent)

createDecreaseButton

protected JButton createDecreaseButton(int orientation)

createIncreaseButton

protected JButton createIncreaseButton(int orientation)

paintDecreaseHighlight

protected void paintDecreaseHighlight(Graphics g)

paintIncreaseHighlight

protected void paintIncreaseHighlight(Graphics g)

paintTrack

protected void paintTrack(Graphics g, JComponent c, Rectangle trackBounds)

paintThumb

protected void paintThumb(Graphics g, JComponent c, Rectangle thumbBounds)

getMinimumThumbSize

protected Dimension getMinimumThumbSize()

Return 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:

getMaximumThumbSize()

getMaximumThumbSize

protected Dimension getMaximumThumbSize()

Return the largest acceptable size for the thumb. To create a fixed size thumb one make this method and getMinimumThumbSize return 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:

getMinimumThumbSize()

addLayoutComponent

public void addLayoutComponent(String name, Component child)

Description copied from interface: [LayoutManager](../../../../java/awt/LayoutManager.html#addLayoutComponent%28java.lang.String, java.awt.Component%29)

If the layout manager uses a per-component string, adds the component comp to the layout, associating it with the string specified by name.

Specified by:

[addLayoutComponent](../../../../java/awt/LayoutManager.html#addLayoutComponent%28java.lang.String, java.awt.Component%29) in interface [LayoutManager](../../../../java/awt/LayoutManager.html "interface in java.awt")

Parameters:

name - the string to be associated with the component

child - the component to be added

removeLayoutComponent

public void removeLayoutComponent(Component child)

Description copied from interface: [LayoutManager](../../../../java/awt/LayoutManager.html#removeLayoutComponent%28java.awt.Component%29)

Removes the specified component from the layout.

Specified by:

[removeLayoutComponent](../../../../java/awt/LayoutManager.html#removeLayoutComponent%28java.awt.Component%29) in interface [LayoutManager](../../../../java/awt/LayoutManager.html "interface in java.awt")

Parameters:

child - the component to be removed

preferredLayoutSize

public Dimension preferredLayoutSize(Container scrollbarContainer)

Description copied from interface: [LayoutManager](../../../../java/awt/LayoutManager.html#preferredLayoutSize%28java.awt.Container%29)

Calculates the preferred size dimensions for the specified container, given the components it contains.

Specified by:

[preferredLayoutSize](../../../../java/awt/LayoutManager.html#preferredLayoutSize%28java.awt.Container%29) in interface [LayoutManager](../../../../java/awt/LayoutManager.html "interface in java.awt")

Parameters:

scrollbarContainer - the container to be laid out

See Also:

LayoutManager.minimumLayoutSize(java.awt.Container)

minimumLayoutSize

public Dimension minimumLayoutSize(Container scrollbarContainer)

Description copied from interface: [LayoutManager](../../../../java/awt/LayoutManager.html#minimumLayoutSize%28java.awt.Container%29)

Calculates the minimum size dimensions for the specified container, given the components it contains.

Specified by:

[minimumLayoutSize](../../../../java/awt/LayoutManager.html#minimumLayoutSize%28java.awt.Container%29) in interface [LayoutManager](../../../../java/awt/LayoutManager.html "interface in java.awt")

Parameters:

scrollbarContainer - the component to be laid out

See Also:

LayoutManager.preferredLayoutSize(java.awt.Container)

layoutVScrollbar

protected void layoutVScrollbar(JScrollBar sb)

layoutHScrollbar

protected void layoutHScrollbar(JScrollBar sb)

layoutContainer

public void layoutContainer(Container scrollbarContainer)

Description copied from interface: [LayoutManager](../../../../java/awt/LayoutManager.html#layoutContainer%28java.awt.Container%29)

Lays out the specified container.

Specified by:

[layoutContainer](../../../../java/awt/LayoutManager.html#layoutContainer%28java.awt.Container%29) in interface [LayoutManager](../../../../java/awt/LayoutManager.html "interface in java.awt")

Parameters:

scrollbarContainer - the container to be laid out

setThumbBounds

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

See Also:

getThumbBounds()

getThumbBounds

protected Rectangle getThumbBounds()

Return 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:

[setThumbBounds(int, int, int, int)](../../../../javax/swing/plaf/basic/BasicScrollBarUI.html#setThumbBounds%28int, int, int, int%29)

getTrackBounds

protected Rectangle getTrackBounds()

Returns 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:

layoutContainer(java.awt.Container)

scrollByBlock

protected void scrollByBlock(int direction)

scrollByUnit

protected void scrollByUnit(int direction)

getSupportsAbsolutePositioning

public 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

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 © 2004, 2010 Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.