java.lang.Object
javax.swing.plaf.ComponentUI
javax.swing.plaf.ToolBarUI
javax.swing.plaf.basic.BasicToolBarUI
- All Implemented Interfaces:
SwingConstants
- Direct Known Subclasses:
MetalToolBarUI
,SynthToolBarUI
public class BasicToolBarUI extends ToolBarUI implements SwingConstants
A Basic L&F implementation of ToolBarUI. This implementation
is a "combined" view/controller.
-
Nested Class Summary
Nested Classes Modifier and Type Class Description class
BasicToolBarUI.DockingListener
This class should be treated as a "protected" inner class.protected class
BasicToolBarUI.DragWindow
The window which appears during dragging theJToolBar
.protected class
BasicToolBarUI.FrameListener
The class listens for window events.protected class
BasicToolBarUI.PropertyListener
The class listens for property changed events.protected class
BasicToolBarUI.ToolBarContListener
The class listens for component events.protected class
BasicToolBarUI.ToolBarFocusListener
The class listens for focus events. -
Field Summary
Fields Modifier and Type Field Description protected String
constraintBeforeFloating
The layout before floating.protected Color
dockingBorderColor
The color of the docking border.protected Color
dockingColor
The background color of the docking border.protected MouseInputListener
dockingListener
The instance of aMouseInputListener
.protected KeyStroke
downKey
Deprecated.As of Java 2 platform v1.3.protected BasicToolBarUI.DragWindow
dragWindow
The instance ofDragWindow
.protected Color
floatingBorderColor
The color of the not docking border.protected Color
floatingColor
The background color of the not docking border.protected int
focusedCompIndex
The index of the focused component.protected KeyStroke
leftKey
Deprecated.As of Java 2 platform v1.3.protected PropertyChangeListener
propertyListener
The instance of aPropertyChangeListener
.protected KeyStroke
rightKey
Deprecated.As of Java 2 platform v1.3.protected JToolBar
toolBar
The instance ofJToolBar
.protected ContainerListener
toolBarContListener
The instance of aContainerListener
.protected FocusListener
toolBarFocusListener
The instance of aFocusListener
.protected KeyStroke
upKey
Deprecated.As of Java 2 platform v1.3.Fields declared in interface javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
-
Constructor Summary
Constructors Constructor Description BasicToolBarUI()
-
Method Summary
Modifier and Type Method Description boolean
canDock(Component c, Point p)
Returnstrue
if theJToolBar
can dock at the given position.protected MouseInputListener
createDockingListener()
Returns an instance ofMouseInputListener
.protected BasicToolBarUI.DragWindow
createDragWindow(JToolBar toolbar)
Returns an instance ofDragWindow
.protected JFrame
createFloatingFrame(JToolBar toolbar)
No longer used, use BasicToolBarUI.createFloatingWindow(JToolBar)protected RootPaneContainer
createFloatingWindow(JToolBar toolbar)
Creates a window which contains the toolbar after it has been dragged out from its containerprotected WindowListener
createFrameListener()
Constructs a new instance ofWindowListener
.protected Border
createNonRolloverBorder()
Creates the non rollover border for toolbar components.protected PropertyChangeListener
createPropertyListener()
Returns an instance ofPropertyChangeListener
.protected Border
createRolloverBorder()
Creates a rollover border for toolbar components.protected ContainerListener
createToolBarContListener()
Returns an instance ofContainerListener
.protected FocusListener
createToolBarFocusListener()
Returns an instance ofFocusListener
.static ComponentUI
createUI(JComponent c)
Constructs a new instance ofBasicToolBarUI
.protected void
dragTo(Point position, Point origin)
The method is used to dragDragWindow
during theJToolBar
is being dragged.protected void
floatAt(Point position, Point origin)
The method is called at end of dragging to place the frame in either its original place or in its floating frame.Color
getDockingColor()
Gets the color displayed when over a docking areaColor
getFloatingColor()
Gets the color displayed when over a floating areaprotected Border
getNonRolloverBorder(AbstractButton b)
Returns a non-rollover border for the button.protected Border
getRolloverBorder(AbstractButton b)
Returns a rollover border for the button.protected void
installComponents()
Registers components.protected void
installDefaults()
Installs default properties.protected void
installKeyboardActions()
Registers keyboard actions.protected void
installListeners()
Registers listeners.protected void
installNonRolloverBorders(JComponent c)
Installs non-rollover borders on all the child components of the JComponent.protected void
installNormalBorders(JComponent c)
Installs normal borders on all the child components of the JComponent.protected void
installRolloverBorders(JComponent c)
Installs rollover borders on all the child components of the JComponent.boolean
isFloating()
Returnstrue
if theJToolBar
is floatingboolean
isRolloverBorders()
Returns a flag to determine whether rollover button borders are enabled.protected void
navigateFocusedComp(int direction)
Navigates the focused component.protected void
paintDragWindow(Graphics g)
Paints the contents of the window used for dragging.protected void
setBorderToNonRollover(Component c)
Sets the border of the component to have a non-rollover border which was created by thecreateNonRolloverBorder()
method.protected void
setBorderToNormal(Component c)
Sets the border of the component to have a normal border.protected void
setBorderToRollover(Component c)
Sets the border of the component to have a rollover border which was created by thecreateRolloverBorder()
method.void
setDockingColor(Color c)
Sets the color displayed when over a docking areavoid
setFloating(boolean b, Point p)
Sets the floating property.void
setFloatingColor(Color c)
Sets the color displayed when over a floating areavoid
setFloatingLocation(int x, int y)
Sets the floating location.void
setOrientation(int orientation)
Sets the tool bar's orientation.void
setRolloverBorders(boolean rollover)
Sets the flag for enabling rollover borders on the toolbar and it will also install the appropriate border depending on the state of the flag.protected void
uninstallComponents()
Unregisters components.protected void
uninstallDefaults()
Uninstalls default properties.protected void
uninstallKeyboardActions()
Unregisters keyboard actions.protected void
uninstallListeners()
Unregisters listeners.Methods declared in class javax.swing.plaf.ComponentUI
contains, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMaximumSize, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, update
-
Field Details
-
toolBar
The instance ofJToolBar
. -
dragWindow
The instance ofDragWindow
. -
focusedCompIndex
protected int focusedCompIndexThe index of the focused component. -
dockingColor
The background color of the docking border. -
floatingColor
The background color of the not docking border. -
dockingBorderColor
The color of the docking border. -
floatingBorderColor
The color of the not docking border. -
dockingListener
The instance of aMouseInputListener
. -
propertyListener
The instance of aPropertyChangeListener
. -
toolBarContListener
The instance of aContainerListener
. -
toolBarFocusListener
The instance of aFocusListener
. -
constraintBeforeFloating
The layout before floating. -
upKey
Deprecated.As of Java 2 platform v1.3.As of Java 2 platform v1.3 this previously undocumented field is no longer used. Key bindings are now defined by the LookAndFeel, please refer to the key bindings specification for further details. -
downKey
Deprecated.As of Java 2 platform v1.3.As of Java 2 platform v1.3 this previously undocumented field is no longer used. Key bindings are now defined by the LookAndFeel, please refer to the key bindings specification for further details. -
leftKey
Deprecated.As of Java 2 platform v1.3.As of Java 2 platform v1.3 this previously undocumented field is no longer used. Key bindings are now defined by the LookAndFeel, please refer to the key bindings specification for further details. -
rightKey
Deprecated.As of Java 2 platform v1.3.As of Java 2 platform v1.3 this previously undocumented field is no longer used. Key bindings are now defined by the LookAndFeel, please refer to the key bindings specification for further details.
-
-
Constructor Details
-
BasicToolBarUI
public BasicToolBarUI()
-
-
Method Details
-
createUI
Constructs a new instance ofBasicToolBarUI
.- Parameters:
c
- a component- Returns:
- a new instance of
BasicToolBarUI
-
installDefaults
protected void installDefaults()Installs default properties. -
uninstallDefaults
protected void uninstallDefaults()Uninstalls default properties. -
installComponents
protected void installComponents()Registers components. -
uninstallComponents
protected void uninstallComponents()Unregisters components. -
installListeners
protected void installListeners()Registers listeners. -
uninstallListeners
protected void uninstallListeners()Unregisters listeners. -
installKeyboardActions
protected void installKeyboardActions()Registers keyboard actions. -
uninstallKeyboardActions
protected void uninstallKeyboardActions()Unregisters keyboard actions. -
createRolloverBorder
Creates a rollover border for toolbar components. The rollover border will be installed if rollover borders are enabled.Override this method to provide an alternate rollover border.
- Returns:
- a rollover border for toolbar components
- Since:
- 1.4
-
createNonRolloverBorder
Creates the non rollover border for toolbar components. This border will be installed as the border for components added to the toolbar if rollover borders are not enabled.Override this method to provide an alternate rollover border.
- Returns:
- the non rollover border for toolbar components
- Since:
- 1.4
-
createFloatingFrame
No longer used, use BasicToolBarUI.createFloatingWindow(JToolBar)- Parameters:
toolbar
- an instance ofJToolBar
- Returns:
- an instance of
JFrame
- See Also:
createFloatingWindow(javax.swing.JToolBar)
-
createFloatingWindow
Creates a window which contains the toolbar after it has been dragged out from its container- Parameters:
toolbar
- an instance ofJToolBar
- Returns:
- a
RootPaneContainer
object, containing the toolbar - Since:
- 1.4
-
createDragWindow
Returns an instance ofDragWindow
.- Parameters:
toolbar
- an instance ofJToolBar
- Returns:
- an instance of
DragWindow
-
isRolloverBorders
public boolean isRolloverBorders()Returns a flag to determine whether rollover button borders are enabled.- Returns:
- true if rollover borders are enabled; false otherwise
- Since:
- 1.4
- See Also:
setRolloverBorders(boolean)
-
setRolloverBorders
public void setRolloverBorders(boolean rollover)Sets the flag for enabling rollover borders on the toolbar and it will also install the appropriate border depending on the state of the flag.- Parameters:
rollover
- if true, rollover borders are installed. Otherwise non-rollover borders are installed- Since:
- 1.4
- See Also:
isRolloverBorders()
-
installRolloverBorders
Installs rollover borders on all the child components of the JComponent.This is a convenience method to call
setBorderToRollover
for each child component.- Parameters:
c
- container which holds the child components (usually a JToolBar)- Since:
- 1.4
- See Also:
setBorderToRollover(java.awt.Component)
-
installNonRolloverBorders
Installs non-rollover borders on all the child components of the JComponent. A non-rollover border is the border that is installed on the child component while it is in the toolbar.This is a convenience method to call
setBorderToNonRollover
for each child component.- Parameters:
c
- container which holds the child components (usually a JToolBar)- Since:
- 1.4
- See Also:
setBorderToNonRollover(java.awt.Component)
-
installNormalBorders
Installs normal borders on all the child components of the JComponent. A normal border is the original border that was installed on the child component before it was added to the toolbar.This is a convenience method to call
setBorderNormal
for each child component.- Parameters:
c
- container which holds the child components (usually a JToolBar)- Since:
- 1.4
- See Also:
setBorderToNonRollover(java.awt.Component)
-
setBorderToRollover
Sets the border of the component to have a rollover border which was created by thecreateRolloverBorder()
method.- Parameters:
c
- component which will have a rollover border installed- Since:
- 1.4
- See Also:
createRolloverBorder()
-
getRolloverBorder
Returns a rollover border for the button.- Parameters:
b
- the button to calculate the rollover border for- Returns:
- the rollover border
- Since:
- 1.6
- See Also:
setBorderToRollover(java.awt.Component)
-
setBorderToNonRollover
Sets the border of the component to have a non-rollover border which was created by thecreateNonRolloverBorder()
method.- Parameters:
c
- component which will have a non-rollover border installed- Since:
- 1.4
- See Also:
createNonRolloverBorder()
-
getNonRolloverBorder
Returns a non-rollover border for the button.- Parameters:
b
- the button to calculate the non-rollover border for- Returns:
- the non-rollover border
- Since:
- 1.6
- See Also:
setBorderToNonRollover(java.awt.Component)
-
setBorderToNormal
Sets the border of the component to have a normal border. A normal border is the original border that was installed on the child component before it was added to the toolbar.- Parameters:
c
- component which will have a normal border re-installed- Since:
- 1.4
- See Also:
createNonRolloverBorder()
-
setFloatingLocation
public void setFloatingLocation(int x, int y)Sets the floating location.- Parameters:
x
- an X coordinatey
- an Y coordinate
-
isFloating
public boolean isFloating()Returnstrue
if theJToolBar
is floating- Returns:
true
if theJToolBar
is floating
-
setFloating
Sets the floating property.- Parameters:
b
-true
if theJToolBar
is floatingp
- the position
-
setOrientation
public void setOrientation(int orientation)Sets the tool bar's orientation.- Parameters:
orientation
- the new orientation
-
getDockingColor
Gets the color displayed when over a docking area- Returns:
- the color displayed when over a docking area
-
setDockingColor
Sets the color displayed when over a docking area- Parameters:
c
- the new color
-
getFloatingColor
Gets the color displayed when over a floating area- Returns:
- the color displayed when over a floating area
-
setFloatingColor
Sets the color displayed when over a floating area- Parameters:
c
- the new color
-
canDock
Returnstrue
if theJToolBar
can dock at the given position.- Parameters:
c
- a componentp
- a position- Returns:
true
if theJToolBar
can dock at the given position
-
dragTo
The method is used to dragDragWindow
during theJToolBar
is being dragged.- Parameters:
position
- the relative to theJTollBar
positionorigin
- the screen position ofJToolBar
before dragging
-
floatAt
The method is called at end of dragging to place the frame in either its original place or in its floating frame.- Parameters:
position
- the relative to theJTollBar
positionorigin
- the screen position ofJToolBar
before dragging
-
createToolBarContListener
Returns an instance ofContainerListener
.- Returns:
- an instance of
ContainerListener
-
createToolBarFocusListener
Returns an instance ofFocusListener
.- Returns:
- an instance of
FocusListener
-
createPropertyListener
Returns an instance ofPropertyChangeListener
.- Returns:
- an instance of
PropertyChangeListener
-
createDockingListener
Returns an instance ofMouseInputListener
.- Returns:
- an instance of
MouseInputListener
-
createFrameListener
Constructs a new instance ofWindowListener
.- Returns:
- a new instance of
WindowListener
-
paintDragWindow
Paints the contents of the window used for dragging.- Parameters:
g
- Graphics to paint to.- Throws:
NullPointerException
- isg
is null- Since:
- 1.5
-