javax.swing.plaf.basic

Class BasicToolBarUI

public class BasicToolBarUI extends ToolBarUI implements SwingConstants

This is the Basic Look and Feel UI class for JToolBar.
Nested Class Summary
classBasicToolBarUI.DockingListener
This is the MouseHandler class that allows the user to drag the JToolBar in and out of the parent and dock it if it can.
protected classBasicToolBarUI.DragWindow
This is the window that appears when the JToolBar is being dragged around.
protected classBasicToolBarUI.FrameListener
This helper class listens for Window events from the floatable window and if it is closed, returns the JToolBar to the last known good location.
protected classBasicToolBarUI.PropertyListener
This helper class listens for PropertyChangeEvents from the JToolBar.
protected classBasicToolBarUI.ToolBarContListener
This helper class listens for components added to and removed from the JToolBar.
protected classBasicToolBarUI.ToolBarFocusListener
DOCUMENT ME!
Field Summary
protected StringconstraintBeforeFloating
The last known BorderLayout constraint before floating.
protected ColordockingBorderColor
The color of the border when it is dockable.
protected ColordockingColor
The background color of the JToolBar when it is dockable.
protected MouseInputListenerdockingListener
The docking listener responsible for mouse events on the JToolBar.
protected KeyStrokedownKey
protected BasicToolBarUI.DragWindowdragWindow
The window used for dragging the JToolBar.
protected ColorfloatingBorderColor
The color of the border when it is not dockable.
protected ColorfloatingColor
The background color of the JToolBar when it is not dockable.
protected intfocusedCompIndex
The index of the focused component.
protected KeyStrokeleftKey
protected PropertyChangeListenerpropertyListener
The PropertyChangeListener for the JToolBar.
protected KeyStrokerightKey
protected JToolBartoolBar
The JToolBar this UI delegate is responsible for.
protected ContainerListenertoolBarContListener
The Container listener for the JToolBar.
protected FocusListenertoolBarFocusListener
The Focus listener for the JToolBar.
protected KeyStrokeupKey
Constructor Summary
BasicToolBarUI()
This method creates a new BasicToolBarUI object for the given JToolBar.
Method Summary
booleancanDock(Component c, Point p)
This method returns whether the JToolBar can dock at the given position.
protected MouseInputListenercreateDockingListener()
This method creates a new DockingListener for the JToolBar.
protected BasicToolBarUI.DragWindowcreateDragWindow(JToolBar toolbar)
This method creates a new DragWindow for the given JToolBar.
protected JFramecreateFloatingFrame(JToolBar toolbar)
This method creates a new floating frame for the JToolBar.
protected RootPaneContainercreateFloatingWindow(JToolBar toolbar)
This method creates a new floating window for the JToolBar.
protected WindowListenercreateFrameListener()
This method creates a new WindowListener for the JToolBar.
protected BordercreateNonRolloverBorder()
This method creates a new nonRolloverBorder for JButtons when the JToolBar's rollover property is set to false.
protected PropertyChangeListenercreatePropertyListener()
This method creates a new PropertyChangeListener for the JToolBar.
protected BordercreateRolloverBorder()
This method creates a new rollover border for JButtons when the JToolBar's rollover property is set to true.
protected ContainerListenercreateToolBarContListener()
This method creates a new Container listener for the JToolBar.
protected FocusListenercreateToolBarFocusListener()
This method creates a new FocusListener for the JToolBar.
static ComponentUIcreateUI(JComponent c)
This method creates a new UI delegate for the given JComponent.
protected voiddragTo(Point position, Point origin)
This method is called to drag the DragWindow around when the JToolBar is being dragged around.
protected voidfloatAt(Point position, Point origin)
This method is used at the end of a drag session to place the frame in either its original parent as a docked JToolBar or in its floating frame.
ColorgetDockingColor()
This method returns the docking color.
ColorgetFloatingColor()
This method returns the Color which is displayed when over a floating area.
DimensiongetMaximumSize(JComponent c)
This method returns the maximum size of the given JComponent for this UI.
DimensiongetMinimumSize(JComponent c)
This method returns the minimum size of the given JComponent for this UI.
protected voidinstallComponents()
This method installs the needed components for the JToolBar.
protected voidinstallDefaults()
This method installs the defaults as specified by the look and feel.
protected voidinstallKeyboardActions()
This method installs the keyboard actions for the JToolBar as specified by the look and feel.
protected voidinstallListeners()
This method installs listeners for the JToolBar.
protected voidinstallNonRolloverBorders(JComponent c)
This method installs non rollover borders for each component inside the given JComponent.
protected voidinstallNormalBorders(JComponent c)
This method installs normal (or their original) borders for each component inside the given JComponent.
protected voidinstallRolloverBorders(JComponent c)
This method install rollover borders for each component inside the given JComponent.
voidinstallUI(JComponent c)
This method installs the UI for the given JComponent.
booleanisFloating()
This method returns whether the JToolBar is floating.
booleanisRolloverBorders()
This method returns whether rollover borders have been set.
protected voidnavigateFocusedComp(int direction)
This method navigates in the given direction giving focus to the next component in the given direction.
protected voidsetBorderToNonRollover(Component c)
This method sets the border of the given component to a non rollover border.
protected voidsetBorderToNormal(Component c)
This method sets the border of the given component to its original value.
protected voidsetBorderToRollover(Component c)
This method sets the border of the given component to a rollover border.
voidsetDockingColor(Color c)
This method sets the docking color.
voidsetFloating(boolean b, Point p)
This method sets the floating property for the JToolBar.
voidsetFloatingColor(Color c)
This method sets the color displayed when the JToolBar is not in a dockable area.
voidsetFloatingLocation(int x, int y)
This method sets the floating location of the JToolBar.
voidsetOrientation(int orientation)
This is a convenience method for changing the orientation of the JToolBar.
voidsetRolloverBorders(boolean rollover)
This method changes the child components to have rollover borders if the given parameter is true.
protected voiduninstallComponents()
This method uninstall UI installed components from the JToolBar.
protected voiduninstallDefaults()
This method removes the defaults installed by the Look and Feel.
protected voiduninstallKeyboardActions()
This method uninstalls keyboard actions installed by the UI.
protected voiduninstallListeners()
This method uninstalls listeners installed by the UI.
voiduninstallUI(JComponent c)
This method uninstalls the UI.

Field Detail

constraintBeforeFloating

protected String constraintBeforeFloating
The last known BorderLayout constraint before floating.

dockingBorderColor

protected Color dockingBorderColor
The color of the border when it is dockable.

dockingColor

protected Color dockingColor
The background color of the JToolBar when it is dockable.

dockingListener

protected MouseInputListener dockingListener
The docking listener responsible for mouse events on the JToolBar.

downKey

protected KeyStroke downKey

Deprecated: since JDK1.3.

dragWindow

protected BasicToolBarUI.DragWindow dragWindow
The window used for dragging the JToolBar.

floatingBorderColor

protected Color floatingBorderColor
The color of the border when it is not dockable.

floatingColor

protected Color floatingColor
The background color of the JToolBar when it is not dockable.

focusedCompIndex

protected int focusedCompIndex
The index of the focused component.

leftKey

protected KeyStroke leftKey

Deprecated: since JDK1.3.

propertyListener

protected PropertyChangeListener propertyListener
The PropertyChangeListener for the JToolBar.

rightKey

protected KeyStroke rightKey

Deprecated: since JDK1.3.

toolBar

protected JToolBar toolBar
The JToolBar this UI delegate is responsible for.

toolBarContListener

protected ContainerListener toolBarContListener
The Container listener for the JToolBar.

toolBarFocusListener

protected FocusListener toolBarFocusListener
The Focus listener for the JToolBar.

upKey

protected KeyStroke upKey

Deprecated: since JDK1.3.

Constructor Detail

BasicToolBarUI

public BasicToolBarUI()
This method creates a new BasicToolBarUI object for the given JToolBar.

Method Detail

canDock

public boolean canDock(Component c, Point p)
This method returns whether the JToolBar can dock at the given position.

Parameters: c The component to try to dock in. p The position of the mouse cursor relative to the given component.

Returns: Whether the JToolBar can dock.

createDockingListener

protected MouseInputListener createDockingListener()
This method creates a new DockingListener for the JToolBar.

Returns: A new DockingListener for the JToolBar.

createDragWindow

protected BasicToolBarUI.DragWindow createDragWindow(JToolBar toolbar)
This method creates a new DragWindow for the given JToolBar.

Parameters: toolbar The JToolBar to create a DragWindow for.

Returns: A new DragWindow.

createFloatingFrame

protected JFrame createFloatingFrame(JToolBar toolbar)
This method creates a new floating frame for the JToolBar. By default, this UI uses createFloatingWindow instead. This method of creating a floating frame is deprecated.

Parameters: toolbar The JToolBar to create a floating frame for.

Returns: A new floating frame.

createFloatingWindow

protected RootPaneContainer createFloatingWindow(JToolBar toolbar)
This method creates a new floating window for the JToolBar. This is the method used by default to create a floating container for the JToolBar.

Parameters: toolbar The JToolBar to create a floating window for.

Returns: A new floating window.

createFrameListener

protected WindowListener createFrameListener()
This method creates a new WindowListener for the JToolBar.

Returns: A new WindowListener.

createNonRolloverBorder

protected Border createNonRolloverBorder()
This method creates a new nonRolloverBorder for JButtons when the JToolBar's rollover property is set to false.

Returns: A new NonRolloverBorder.

createPropertyListener

protected PropertyChangeListener createPropertyListener()
This method creates a new PropertyChangeListener for the JToolBar.

Returns: A new PropertyChangeListener.

createRolloverBorder

protected Border createRolloverBorder()
This method creates a new rollover border for JButtons when the JToolBar's rollover property is set to true.

Returns: A new rollover border.

createToolBarContListener

protected ContainerListener createToolBarContListener()
This method creates a new Container listener for the JToolBar.

Returns: A new Container listener.

createToolBarFocusListener

protected FocusListener createToolBarFocusListener()
This method creates a new FocusListener for the JToolBar.

Returns: A new FocusListener for the JToolBar.

createUI

public static ComponentUI createUI(JComponent c)
This method creates a new UI delegate for the given JComponent.

Parameters: c The JComponent to create a UI delegate for.

Returns: A new UI delegate.

dragTo

protected void dragTo(Point position, Point origin)
This method is called to drag the DragWindow around when the JToolBar is being dragged around.

Parameters: position The mouse cursor coordinates relative to the JToolBar. origin The screen position of the JToolBar.

floatAt

protected void floatAt(Point position, Point origin)
This method is used at the end of a drag session to place the frame in either its original parent as a docked JToolBar or in its floating frame.

Parameters: position The position of the mouse cursor relative to the JToolBar. origin The screen position of the JToolBar before the drag session started.

getDockingColor

public Color getDockingColor()
This method returns the docking color.

Returns: The docking color.

getFloatingColor

public Color getFloatingColor()
This method returns the Color which is displayed when over a floating area.

Returns: The color which is displayed when over a floating area.

getMaximumSize

public Dimension getMaximumSize(JComponent c)
This method returns the maximum size of the given JComponent for this UI.

Parameters: c The JComponent to find the maximum size for.

Returns: The maximum size for this UI.

getMinimumSize

public Dimension getMinimumSize(JComponent c)
This method returns the minimum size of the given JComponent for this UI.

Parameters: c The JComponent to find a minimum size for.

Returns: The minimum size for this UI.

installComponents

protected void installComponents()
This method installs the needed components for the JToolBar.

installDefaults

protected void installDefaults()
This method installs the defaults as specified by the look and feel.

installKeyboardActions

protected void installKeyboardActions()
This method installs the keyboard actions for the JToolBar as specified by the look and feel.

installListeners

protected void installListeners()
This method installs listeners for the JToolBar.

installNonRolloverBorders

protected void installNonRolloverBorders(JComponent c)
This method installs non rollover borders for each component inside the given JComponent.

Parameters: c The JComponent whose children need to have non rollover borders installed.

installNormalBorders

protected void installNormalBorders(JComponent c)
This method installs normal (or their original) borders for each component inside the given JComponent.

Parameters: c The JComponent whose children need to have their original borders installed.

installRolloverBorders

protected void installRolloverBorders(JComponent c)
This method install rollover borders for each component inside the given JComponent.

Parameters: c The JComponent whose children need to have rollover borders installed.

installUI

public void installUI(JComponent c)
This method installs the UI for the given JComponent.

Parameters: c The JComponent to install a UI for.

isFloating

public boolean isFloating()
This method returns whether the JToolBar is floating.

Returns: Whether the JToolBar is floating.

isRolloverBorders

public boolean isRolloverBorders()
This method returns whether rollover borders have been set.

Returns: Whether rollover borders have been set.

navigateFocusedComp

protected void navigateFocusedComp(int direction)
This method navigates in the given direction giving focus to the next component in the given direction.

Parameters: direction The direction to give focus to.

setBorderToNonRollover

protected void setBorderToNonRollover(Component c)
This method sets the border of the given component to a non rollover border.

Parameters: c The Component whose border needs to be set.

setBorderToNormal

protected void setBorderToNormal(Component c)
This method sets the border of the given component to its original value.

Parameters: c The Component whose border needs to be set.

setBorderToRollover

protected void setBorderToRollover(Component c)
This method sets the border of the given component to a rollover border.

Parameters: c The Component whose border needs to be set.

setDockingColor

public void setDockingColor(Color c)
This method sets the docking color.

Parameters: c The docking color.

setFloating

public void setFloating(boolean b, Point p)
This method sets the floating property for the JToolBar.

Parameters: b Whether the JToolBar is floating. p FIXME

setFloatingColor

public void setFloatingColor(Color c)
This method sets the color displayed when the JToolBar is not in a dockable area.

Parameters: c The floating color.

setFloatingLocation

public void setFloatingLocation(int x, int y)
This method sets the floating location of the JToolBar.

Parameters: x The x coordinate for the floating frame. y The y coordinate for the floating frame.

setOrientation

public void setOrientation(int orientation)
This is a convenience method for changing the orientation of the JToolBar.

Parameters: orientation The new orientation.

setRolloverBorders

public void setRolloverBorders(boolean rollover)
This method changes the child components to have rollover borders if the given parameter is true. Otherwise, the components are set to have non rollover borders.

Parameters: rollover Whether the children will have rollover borders.

uninstallComponents

protected void uninstallComponents()
This method uninstall UI installed components from the JToolBar.

uninstallDefaults

protected void uninstallDefaults()
This method removes the defaults installed by the Look and Feel.

uninstallKeyboardActions

protected void uninstallKeyboardActions()
This method uninstalls keyboard actions installed by the UI.

uninstallListeners

protected void uninstallListeners()
This method uninstalls listeners installed by the UI.

uninstallUI

public void uninstallUI(JComponent c)
This method uninstalls the UI.

Parameters: c The JComponent that is having this UI removed.