javax.swing.plaf.basic
Class BasicToolBarUI

java.lang.Object
  javax.swing.plaf.ComponentUI
      javax.swing.plaf.ToolBarUI
          javax.swing.plaf.basic.BasicToolBarUI

All Implemented Interfaces:

SwingConstants

Direct Known Subclasses:

MetalToolBarUI

public class BasicToolBarUI

extends ToolBarUI

implements SwingConstants

A Basic L&F implementation of ToolBarUI. This implementation is a "combined" view/controller.

Nested Class Summary
class	BasicToolBarUI.DockingListener           This inner class should be treated as is marked "public" due to a "protected" inner class. compiler bug.
protected  class	BasicToolBarUI.DragWindow
protected  class	BasicToolBarUI.FrameListener
protected  class	BasicToolBarUI.PropertyListener
protected  class	BasicToolBarUI.ToolBarContListener
protected  class	BasicToolBarUI.ToolBarFocusListener

 

Field Summary
protected   String	constraintBeforeFloating
protected   Color	dockingBorderColor
protected   Color	dockingColor
protected   MouseInputListener	dockingListener
protected   KeyStroke	downKey            Deprecated.   As of Java 2 platform v1.3.
protected   BasicToolBarUI.DragWindow	dragWindow
protected   Color	floatingBorderColor
protected   Color	floatingColor
protected  int	focusedCompIndex
protected   KeyStroke	leftKey            Deprecated.   As of Java 2 platform v1.3.
protected   PropertyChangeListener	propertyListener
protected   KeyStroke	rightKey            Deprecated.   As of Java 2 platform v1.3.
protected   JToolBar	toolBar
protected   ContainerListener	toolBarContListener
protected   FocusListener	toolBarFocusListener
protected   KeyStroke	upKey            Deprecated.   As of Java 2 platform v1.3.

 

Fields inherited from 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
BasicToolBarUI ()

 

Method Summary
boolean	canDock ( Component  c, Point  p)
protected   MouseInputListener	createDockingListener ()
protected   BasicToolBarUI.DragWindow	createDragWindow ( JToolBar  toolbar)
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 container
protected   WindowListener	createFrameListener ()
protected   Border	createNonRolloverBorder ()           Creates the non rollover border for toolbar components.
protected   PropertyChangeListener	createPropertyListener ()
protected   Border	createRolloverBorder ()           Creates a rollover border for toolbar components.
protected   ContainerListener	createToolBarContListener ()
protected   FocusListener	createToolBarFocusListener ()
static  ComponentUI	createUI ( JComponent  c)
protected  void	dragTo ( Point  position, Point  origin)
protected  void	floatAt ( Point  position, Point  origin)
Color	getDockingColor ()           Gets the color displayed when over a docking area
Color	getFloatingColor ()           Gets the color displayed when over a floating area
Dimension	getMaximumSize ( JComponent           Returns the specified component's maximum size appropriate for the look and feel.
Dimension	getMinimumSize ( JComponent           Returns the specified component's minimum size appropriate for the look and feel.
Dimension	getPreferredSize ( JComponent           Returns the specified component's preferred size appropriate for the look and feel.
protected  void	installComponents ()
protected  void	installDefaults ()
protected  void	installKeyboardActions ()
protected  void	installListeners ()
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.
void	installUI ( JComponent  c)           Configures the specified component appropriate for the look and feel.
boolean	isFloating ()
boolean	isRolloverBorders ()           Returns a flag to determine whether rollover button borders are enabled.
protected  void	navigateFocusedComp (int direction)
protected  void	paintDragWindow ( Graphics           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 createNonRolloverBorder.
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 createRolloverBorder.
void	setDockingColor ( Color  c)           Sets the color displayed when over a docking area
void	setFloating (boolean b, Point  p)
void	setFloatingColor ( Color  c)           Sets the color displayed when over a floating area
void	setFloatingLocation (int x, int y)
void	setOrientation (int orientation)
void	setRolloverBorders (boolean rollover)           Sets the flag for enabling rollover borders on the toolbar and it will also install the apropriate border depending on the state of the flag.
protected  void	uninstallComponents ()
protected  void	uninstallDefaults ()
protected  void	uninstallKeyboardActions ()
protected  void	uninstallListeners ()
void	uninstallUI ( JComponent  c)           Reverses configuration which was done on the specified component during installUI.

 

Methods inherited from class javax.swing.plaf. ComponentUI
contains , getAccessibleChild , getAccessibleChildrenCount , getMaximumSize , getMinimumSize , getPreferredSize , paint , update

 

Methods inherited from class java.lang. Object
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

 

Field Detail

toolBar

protected JToolBar toolBar

dragWindow

protected BasicToolBarUI.DragWindow dragWindow

focusedCompIndex

protected int focusedCompIndex

dockingColor

protected Color dockingColor

floatingColor

protected Color floatingColor

dockingBorderColor

protected Color dockingBorderColor

floatingBorderColor

protected Color floatingBorderColor

dockingListener

protected MouseInputListener dockingListener

propertyListener

protected PropertyChangeListener propertyListener

toolBarContListener

protected ContainerListener toolBarContListener

toolBarFocusListener

protected FocusListener toolBarFocusListener

constraintBeforeFloating

protected String constraintBeforeFloating

upKey

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

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

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

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

BasicToolBarUI

public BasicToolBarUI()

createUI

public static ComponentUI createUI(JComponent c)

installUI

public void installUI(JComponent c)

Description copied from class: ComponentUI

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 in class ComponentUI

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

Reverses configuration which was done on the specified component during installUI. 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 in class ComponentUI

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

uninstallDefaults

protected void uninstallDefaults()

installComponents

protected void installComponents()

uninstallComponents

protected void uninstallComponents()

installListeners

protected void installListeners()

uninstallListeners

protected void uninstallListeners()

installKeyboardActions

protected void installKeyboardActions()

uninstallKeyboardActions

protected void uninstallKeyboardActions()

navigateFocusedComp

protected void navigateFocusedComp(int direction)

createRolloverBorder

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

Since:

1.4

createNonRolloverBorder

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

Since:

1.4

createFloatingFrame

protected JFrame createFloatingFrame(JToolBar toolbar)

No longer used, use BasicToolBarUI.createFloatingWindow(JToolBar)

See Also:

createFloatingWindow(javax.swing.JToolBar)

createFloatingWindow

protected RootPaneContainer createFloatingWindow(JToolBar toolbar)

Creates a window which contains the toolbar after it has been dragged out from its container

Returns:

a RootPaneContainer object, containing the toolbar.

createDragWindow

protected BasicToolBarUI.DragWindow createDragWindow(JToolBar toolbar)

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 apropriate 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

protected void installRolloverBorders(JComponent c)

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 (usally a JToolBar)

Since:

1.4

See Also:

setBorderToRollover(java.awt.Component)

installNonRolloverBorders

protected void installNonRolloverBorders(JComponent c)

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 (usally a JToolBar)

Since:

1.4

See Also:

setBorderToNonRollover(java.awt.Component)

installNormalBorders

protected void installNormalBorders(JComponent c)

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 (usally a JToolBar)

Since:

1.4

See Also:

setBorderToNonRollover(java.awt.Component)

setBorderToRollover

protected void setBorderToRollover(Component c)

Sets the border of the component to have a rollover border which was created by createRolloverBorder.

Parameters:

c - component which will have a rollover border installed

Since:

1.4

See Also:

createRolloverBorder()

setBorderToNonRollover

protected void setBorderToNonRollover(Component c)

Sets the border of the component to have a non-rollover border which was created by createNonRolloverBorder.

Parameters:

c - component which will have a non-rollover border installed

Since:

1.4

See Also:

createNonRolloverBorder()

setBorderToNormal

protected void setBorderToNormal(Component c)

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 getMinimumSize

public void 
public DimensionsetFloatingLocation getMinimumSize (int x,
 int y) ( JComponent c) 

Description copied from class: ComponentUI

Returns the specified component's minimum size appropriate for the look and feel. If null is returned, the minimum 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:

getMinimumSize in class ComponentUI

Parameters:

c - the component whose minimum 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:

a Dimension object or null

See Also:

JComponent.getMinimumSize() , LayoutManager.minimumLayoutSize(java.awt.Container) , ComponentUI.getPreferredSize(javax.swing.JComponent)

isFloating getPreferredSize

public boolean 
public DimensionisFloating getPreferredSize () ( JComponent c) 

Description copied from class: ComponentUI

Returns the specified component's preferred size appropriate for the look and feel. If null is returned, the preferred 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 returns null.

Overrides:

getPreferredSize in class ComponentUI

Parameters:

c - the component whose preferred size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components

See Also:

JComponent.getPreferredSize() , LayoutManager.preferredLayoutSize(java.awt.Container)

getMaximumSize

 
public DimensiongetMaximumSize ( JComponent c) 

Description copied from class: ComponentUI

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 in class ComponentUI

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:

a Dimension object or null

See Also:

JComponent.getMaximumSize() , LayoutManager2.maximumLayoutSize(java.awt.Container)

setFloatingLocation

 
public void setFloatingLocation (int x,
 int y) 

setFloating isFloating

public void boolean setFloating isFloating (boolean b,
 Point p) () 

setOrientation setFloating

public void setOrientation setFloating (int orientation) (boolean b,
 Point p) 

getDockingColor setOrientation

public Color
public void getDockingColor setOrientation () (int orientation) 

Gets the color displayed when over a docking area

setDockingColor getDockingColor

public void 
public ColorsetDockingColor getDockingColor ( Color c) () 

Sets Gets the color displayed when over a docking area

getFloatingColor setDockingColor

public Color
public void getFloatingColor setDockingColor () ( Color c) 

Gets Sets the color displayed when over a floating docking area

setFloatingColor getFloatingColor

public void 
public ColorsetFloatingColor getFloatingColor ( Color c) () 

Sets Gets the color displayed when over a floating area

canDock setFloatingColor

public boolean void canDock setFloatingColor ( ComponentColor c,
 Point p)  c) 

Sets the color displayed when over a floating area

dragTo canDock

protected void 
public boolean dragTo canDock ( PointComponent position,
  c,
 Point origin)  p) 

floatAt dragTo

protected void floatAt dragTo (Point position,
 Point origin)

createToolBarContListener floatAt

protected ContainerListener
protected void createToolBarContListener floatAt () ( Point position,
 Point origin) 

createToolBarFocusListener createToolBarContListener

protected FocusListenerContainerListenercreateToolBarFocusListener createToolBarContListener ()

createPropertyListener createToolBarFocusListener

protected PropertyChangeListenerFocusListenercreatePropertyListener createToolBarFocusListener ()

createDockingListener createPropertyListener

protected MouseInputListenerPropertyChangeListenercreateDockingListener createPropertyListener ()

createFrameListener createDockingListener

protected WindowListenerMouseInputListenercreateFrameListener createDockingListener ()

paintDragWindow createFrameListener

protected void 
protected WindowListenerpaintDragWindow createFrameListener ( Graphics g) () 

Paints the contents of the window used for dragging.

Parameters:

g - Graphics to paint to.

Throws:

NullPointerException - is g is null

Since:

1.5