Class BasicScrollPaneUI
java.lang.Object
javax.swing.plaf.ComponentUI
javax.swing.plaf.ScrollPaneUI
javax.swing.plaf.basic.BasicScrollPaneUI
- All Implemented Interfaces:
ScrollPaneConstants
- Direct Known Subclasses:
MetalScrollPaneUI, SynthScrollPaneUI
A default L&F implementation of ScrollPaneUI.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionclass
Deprecated, for removal: This API element is subject to removal in a future version.protected class
MouseWheelHandler is an inner class which implements the MouseWheelListener interface.class
Deprecated, for removal: This API element is subject to removal in a future version.class
Deprecated, for removal: This API element is subject to removal in a future version.class
Deprecated, for removal: This API element is subject to removal in a future version. -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected ChangeListener
ChangeListener
installed on the horizontal scrollbar.protected JScrollPane
The instance ofJScrollPane
.protected PropertyChangeListener
PropertyChangeListener
installed on the scroll pane.protected ChangeListener
ChangeListener
installed on the viewport.protected ChangeListener
ChangeListener
installed on the vertical scrollbar.Fields declared in interface ScrollPaneConstants
COLUMN_HEADER, HORIZONTAL_SCROLLBAR, HORIZONTAL_SCROLLBAR_ALWAYS, HORIZONTAL_SCROLLBAR_AS_NEEDED, HORIZONTAL_SCROLLBAR_NEVER, HORIZONTAL_SCROLLBAR_POLICY, LOWER_LEADING_CORNER, LOWER_LEFT_CORNER, LOWER_RIGHT_CORNER, LOWER_TRAILING_CORNER, ROW_HEADER, UPPER_LEADING_CORNER, UPPER_LEFT_CORNER, UPPER_RIGHT_CORNER, UPPER_TRAILING_CORNER, VERTICAL_SCROLLBAR, VERTICAL_SCROLLBAR_ALWAYS, VERTICAL_SCROLLBAR_AS_NEEDED, VERTICAL_SCROLLBAR_NEVER, VERTICAL_SCROLLBAR_POLICY, VIEWPORT
Modifier and TypeFieldDescriptionstatic final String
Identifies the area at the top the viewport between the upper left corner and the upper right corner.static final String
Identifies a horizontal scrollbar.static final int
Used to set the horizontal scroll bar policy so that horizontal scrollbars are always displayed.static final int
Used to set the horizontal scroll bar policy so that horizontal scrollbars are displayed only when needed.static final int
Used to set the horizontal scroll bar policy so that horizontal scrollbars are never displayed.static final String
Identifies the horizontal scroll bar policy property.static final String
Identifies the lower leading edge corner of the viewport.static final String
Identifies the lower left corner of the viewport.static final String
Identifies the lower right corner of the viewport.static final String
Identifies the lower trailing edge corner of the viewport.static final String
Identifies the area along the left side of the viewport between the upper left corner and the lower left corner.static final String
Identifies the upper leading edge corner of the viewport.static final String
Identifies the upper left corner of the viewport.static final String
Identifies the upper right corner of the viewport.static final String
Identifies the upper trailing edge corner of the viewport.static final String
Identifies a vertical scrollbar.static final int
Used to set the vertical scroll bar policy so that vertical scrollbars are always displayed.static final int
Used to set the vertical scroll bar policy so that vertical scrollbars are displayed only when needed.static final int
Used to set the vertical scroll bar policy so that vertical scrollbars are never displayed.static final String
Identifies the vertical scroll bar policy property.static final String
Identifies a "viewport" or display area, within which scrolled contents are visible. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected ChangeListener
Returns an instance of horizontal scroll barChangeListener
.protected MouseWheelListener
Creates an instance of MouseWheelListener, which is added to the JScrollPane by installUI().protected PropertyChangeListener
Creates an instance ofPropertyChangeListener
that's added to theJScrollPane
byinstallUI()
.static ComponentUI
Returns a new instance ofBasicScrollPaneUI
.protected ChangeListener
Returns an instance of viewportChangeListener
.protected ChangeListener
Returns an instance of vertical scroll barChangeListener
.int
getBaseline
(JComponent c, int width, int height) Returns the baseline.Returns an enum indicating how the baseline of the component changes as the size changes.Returns the specified component's maximum size appropriate for the look and feel.protected void
installDefaults
(JScrollPane scrollpane) Installs default properties.protected void
Registers keyboard actions.protected void
Registers listeners.protected void
Synchronizes theJScrollPane
withViewport
.protected void
Uninstalls default properties.protected void
Unregisters keyboard actions.protected void
Unregisters listeners.protected void
Updates column header.protected void
Updates row header.protected void
Updates a scroll bar display policy.protected void
Updates viewport.Methods declared in class ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, update
Modifier and TypeMethodDescriptionboolean
contains
(JComponent c, int x, int y) Returnstrue
if the specified x,y location is contained within the look and feel's defined shape of the specified component.getAccessibleChild
(JComponent c, int i) Returns thei
thAccessible
child of the object.int
Returns the number of accessible children in the object.Returns the specified component's minimum size appropriate for the look and feel.Returns the specified component's preferred size appropriate for the look and feel.void
Configures the specified component appropriately for the look and feel.void
paint
(Graphics g, JComponent c) Paints the specified component appropriately for the look and feel.void
Reverses configuration which was done on the specified component duringinstallUI
.void
update
(Graphics g, JComponent c) Notifies this UI delegate that it is time to paint the specified component.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Modifier and TypeMethodDescriptionprotected Object
clone()
Creates and returns a copy of this object.boolean
Indicates whether some other object is "equal to" this one.protected void
finalize()
Deprecated, for removal: This API element is subject to removal in a future version.Finalization is deprecated and subject to removal in a future release.final Class
<?> getClass()
Returns the runtime class of thisObject
.int
hashCode()
Returns a hash code value for this object.final void
notify()
Wakes up a single thread that is waiting on this object's monitor.final void
Wakes up all threads that are waiting on this object's monitor.toString()
Returns a string representation of the object.final void
wait()
Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final void
wait
(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.final void
wait
(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
-
Field Details
-
scrollpane
The instance ofJScrollPane
. -
vsbChangeListener
ChangeListener
installed on the vertical scrollbar. -
hsbChangeListener
ChangeListener
installed on the horizontal scrollbar. -
viewportChangeListener
ChangeListener
installed on the viewport. -
spPropertyChangeListener
PropertyChangeListener
installed on the scroll pane.
-
-
Constructor Details
-
BasicScrollPaneUI
public BasicScrollPaneUI()Constructs aBasicScrollPaneUI
.
-
-
Method Details
-
createUI
Returns a new instance ofBasicScrollPaneUI
.- Parameters:
x
- a component.- Returns:
- a new instance of
BasicScrollPaneUI
-
getMaximumSize
Description copied from class:ComponentUI
Returns the specified component's maximum size appropriate for the look and feel. Ifnull
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 invokesgetPreferredSize
and returns that value.- Overrides:
getMaximumSize
in classComponentUI
- 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:
- new Dimension(Short.MAX_VALUE, Short.MAX_VALUE)
- See Also:
-
installDefaults
Installs default properties.- Parameters:
scrollpane
- an instance ofJScrollPane
-
installListeners
Registers listeners.- Parameters:
c
- an instance ofJScrollPane
-
installKeyboardActions
Registers keyboard actions.- Parameters:
c
- an instance ofJScrollPane
-
uninstallDefaults
Uninstalls default properties.- Parameters:
c
- an instance ofJScrollPane
-
uninstallListeners
-
uninstallKeyboardActions
Unregisters keyboard actions.- Parameters:
c
- an instance ofJScrollPane
-
syncScrollPaneWithViewport
protected void syncScrollPaneWithViewport()Synchronizes theJScrollPane
withViewport
. -
getBaseline
Returns the baseline.- Overrides:
getBaseline
in classComponentUI
- Parameters:
c
-JComponent
baseline is being requested forwidth
- the width to get the baseline forheight
- the height to get the baseline for- Returns:
- baseline or a value < 0 indicating there is no reasonable baseline
- Throws:
NullPointerException
- ifc
isnull
IllegalArgumentException
- if width or height is < 0- Since:
- 1.6
- See Also:
-
getBaselineResizeBehavior
Returns an enum indicating how the baseline of the component changes as the size changes.- Overrides:
getBaselineResizeBehavior
in classComponentUI
- Parameters:
c
-JComponent
to return baseline resize behavior for- Returns:
- an enum indicating how the baseline changes as the component size changes
- Throws:
NullPointerException
- ifc
isnull
- Since:
- 1.6
- See Also:
-
createViewportChangeListener
Returns an instance of viewportChangeListener
.- Returns:
- an instance of viewport
ChangeListener
-
createHSBChangeListener
Returns an instance of horizontal scroll barChangeListener
.- Returns:
- an instance of horizontal scroll bar
ChangeListener
-
createVSBChangeListener
Returns an instance of vertical scroll barChangeListener
.- Returns:
- an instance of vertical scroll bar
ChangeListener
-
createMouseWheelListener
Creates an instance of MouseWheelListener, which is added to the JScrollPane by installUI(). The returned MouseWheelListener is used to handle mouse wheel-driven scrolling.- Returns:
- MouseWheelListener which implements wheel-driven scrolling
- Since:
- 1.4
- See Also:
-
updateScrollBarDisplayPolicy
Updates a scroll bar display policy.- Parameters:
e
- the property change event
-
updateViewport
Updates viewport.- Parameters:
e
- the property change event
-
updateRowHeader
Updates row header.- Parameters:
e
- the property change event
-
updateColumnHeader
Updates column header.- Parameters:
e
- the property change event
-
createPropertyChangeListener
Creates an instance ofPropertyChangeListener
that's added to theJScrollPane
byinstallUI()
. Subclasses can override this method to return a customPropertyChangeListener
, e.g.class MyScrollPaneUI extends BasicScrollPaneUI { protected PropertyChangeListener createPropertyChangeListener() { return new MyPropertyChangeListener(); } public class MyPropertyChangeListener extends PropertyChangeListener { public void propertyChange(PropertyChangeEvent e) { if (e.getPropertyName().equals("viewport")) { // do some extra work when the viewport changes } super.propertyChange(e); } } }
- Returns:
- an instance of
PropertyChangeListener
- See Also:
-