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 TypeClassDescriptionclassDeprecated, for removal: This API element is subject to removal in a future version.protected classMouseWheelHandler is an inner class which implements the MouseWheelListener interface.classDeprecated, for removal: This API element is subject to removal in a future version.classDeprecated, for removal: This API element is subject to removal in a future version.classDeprecated, for removal: This API element is subject to removal in a future version. -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected ChangeListenerChangeListenerinstalled on the horizontal scrollbar.protected JScrollPaneThe instance ofJScrollPane.protected PropertyChangeListenerPropertyChangeListenerinstalled on the scroll pane.protected ChangeListenerChangeListenerinstalled on the viewport.protected ChangeListenerChangeListenerinstalled 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, VIEWPORTModifier and TypeFieldDescriptionstatic final StringIdentifies the area at the top the viewport between the upper left corner and the upper right corner.static final StringIdentifies a horizontal scrollbar.static final intUsed to set the horizontal scroll bar policy so that horizontal scrollbars are always displayed.static final intUsed to set the horizontal scroll bar policy so that horizontal scrollbars are displayed only when needed.static final intUsed to set the horizontal scroll bar policy so that horizontal scrollbars are never displayed.static final StringIdentifies the horizontal scroll bar policy property.static final StringIdentifies the lower leading edge corner of the viewport.static final StringIdentifies the lower left corner of the viewport.static final StringIdentifies the lower right corner of the viewport.static final StringIdentifies the lower trailing edge corner of the viewport.static final StringIdentifies the area along the left side of the viewport between the upper left corner and the lower left corner.static final StringIdentifies the upper leading edge corner of the viewport.static final StringIdentifies the upper left corner of the viewport.static final StringIdentifies the upper right corner of the viewport.static final StringIdentifies the upper trailing edge corner of the viewport.static final StringIdentifies a vertical scrollbar.static final intUsed to set the vertical scroll bar policy so that vertical scrollbars are always displayed.static final intUsed to set the vertical scroll bar policy so that vertical scrollbars are displayed only when needed.static final intUsed to set the vertical scroll bar policy so that vertical scrollbars are never displayed.static final StringIdentifies the vertical scroll bar policy property.static final StringIdentifies a "viewport" or display area, within which scrolled contents are visible. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected ChangeListenerReturns an instance of horizontal scroll barChangeListener.protected MouseWheelListenerCreates an instance of MouseWheelListener, which is added to the JScrollPane by installUI().protected PropertyChangeListenerCreates an instance ofPropertyChangeListenerthat's added to theJScrollPanebyinstallUI().static ComponentUIReturns a new instance ofBasicScrollPaneUI.protected ChangeListenerReturns an instance of viewportChangeListener.protected ChangeListenerReturns an instance of vertical scroll barChangeListener.intgetBaseline(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 voidinstallDefaults(JScrollPane scrollpane) Installs default properties.protected voidRegisters keyboard actions.protected voidRegisters listeners.protected voidSynchronizes theJScrollPanewithViewport.protected voidUninstalls default properties.protected voidUnregisters keyboard actions.protected voidUnregisters listeners.protected voidUpdates column header.protected voidUpdates row header.protected voidUpdates a scroll bar display policy.protected voidUpdates viewport.Methods declared in class ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, updateModifier and TypeMethodDescriptionbooleancontains(JComponent c, int x, int y) Returnstrueif 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 theithAccessiblechild of the object.intReturns 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.voidConfigures the specified component appropriately for the look and feel.voidpaint(Graphics g, JComponent c) Paints the specified component appropriately for the look and feel.voidReverses configuration which was done on the specified component duringinstallUI.voidupdate(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, waitModifier and TypeMethodDescriptionprotected Objectclone()Creates and returns a copy of this object.booleanIndicates whether some other object is "equal to" this one.protected voidfinalize()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.inthashCode()Returns a hash code value for this object.final voidnotify()Wakes up a single thread that is waiting on this object's monitor.final voidWakes up all threads that are waiting on this object's monitor.toString()Returns a string representation of the object.final voidwait()Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final voidwait(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 voidwait(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
ChangeListenerinstalled on the vertical scrollbar. -
hsbChangeListener
ChangeListenerinstalled on the horizontal scrollbar. -
viewportChangeListener
ChangeListenerinstalled on the viewport. -
spPropertyChangeListener
PropertyChangeListenerinstalled 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: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 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 theJScrollPanewithViewport. -
getBaseline
Returns the baseline.- Overrides:
getBaselinein classComponentUI- Parameters:
c-JComponentbaseline 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- ifcisnullIllegalArgumentException- 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:
getBaselineResizeBehaviorin classComponentUI- Parameters:
c-JComponentto return baseline resize behavior for- Returns:
- an enum indicating how the baseline changes as the component size changes
- Throws:
NullPointerException- ifcisnull- 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 ofPropertyChangeListenerthat's added to theJScrollPanebyinstallUI(). 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:
-