javax.swing.plaf.basic
Class BasicSplitPaneDivider

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.plaf.basic.BasicSplitPaneDivider
All Implemented Interfaces:
ImageObserver, MenuContainer, PropertyChangeListener, Serializable, EventListener

public class BasicSplitPaneDivider
extends Container
implements PropertyChangeListener

Disabled: no SafeJ information.

Divider used by BasicSplitPaneUI. Subclassers may wish to override paint to do something more interesting. The border effect is drawn in BasicSplitPaneUI, so if you don't like that border, reset it there. To conditionally drag from certain areas subclass mousePressed and call super when you wish the dragging to begin.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.


Nested Class Summary
protected  class BasicSplitPaneDivider.DividerLayout
          Used to layout a BasicSplitPaneDivider.
protected  class BasicSplitPaneDivider.DragController
          Handles the events during a dragging session for a HORIZONTAL_SPLIT oriented split pane.
protected  class BasicSplitPaneDivider.MouseHandler
          MouseHandler is responsible for converting mouse events (released, dragged...) into the appropriate DragController methods.
protected  class BasicSplitPaneDivider.VerticalDragController
          Handles the events during a dragging session for a VERTICAL_SPLIT oriented split pane.
 
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
protected  int dividerSize
          Size of the divider.
protected  BasicSplitPaneDivider.DragController dragger
          Handles mouse dragging message to do the actual dragging.
protected  Component hiddenDivider
          Divider that is used for noncontinuous layout mode.
protected  JButton leftButton
          Button for quickly toggling the left component.
protected  BasicSplitPaneDivider.MouseHandler mouseHandler
          Handles mouse events from both this class, and the split pane.
protected static int ONE_TOUCH_OFFSET
           
protected static int ONE_TOUCH_SIZE
          Width or height of the divider based on orientation BasicSplitPaneUI adds two to this.
protected  int orientation
          Orientation of the JSplitPane.
protected  JButton rightButton
          Button for quickly toggling the right component.
protected  JSplitPane splitPane
          JSplitPane the receiver is contained in.
protected  BasicSplitPaneUI splitPaneUI
          UI this instance was created from.
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
BasicSplitPaneDivider(BasicSplitPaneUI ui)
          Creates an instance of BasicSplitPaneDivider.
 
Method Summary
protected  JButton createLeftOneTouchButton()
          Creates and return an instance of JButton that can be used to collapse the left component in the split pane.
protected  JButton createRightOneTouchButton()
          Creates and return an instance of JButton that can be used to collapse the right component in the split pane.
protected  void dragDividerTo(int location)
          Messages the BasicSplitPaneUI with dragDividerTo that this instance is contained in.
protected  void finishDraggingTo(int location)
          Messages the BasicSplitPaneUI with finishDraggingTo that this instance is contained in.
 BasicSplitPaneUI getBasicSplitPaneUI()
          Returns the SplitPaneUI the receiver is currently in.
 Border getBorder()
          Returns the border of this component or null if no border is currently set.
 int getDividerSize()
          Returns the size of the divider, that is the width if the splitpane is HORIZONTAL_SPLIT, or the height of VERTICAL_SPLIT.
 Insets getInsets()
          If a border has been set on this component, returns the border's insets, else calls super.getInsets.
 Dimension getMinimumSize()
          Returns dividerSize x dividerSize
 Dimension getPreferredSize()
          Returns dividerSize x dividerSize
 boolean isMouseOver()
          Returns whether or not the mouse is currently over the divider
protected  void oneTouchExpandableChanged()
          Messaged when the oneTouchExpandable value of the JSplitPane the receiver is contained in changes.
 void paint(Graphics g)
          Paints the divider.
protected  void prepareForDragging()
          Message to prepare for dragging.
 void propertyChange(PropertyChangeEvent e)
          Property change event, presumably from the JSplitPane, will message updateOrientation if necessary.
 void setBasicSplitPaneUI(BasicSplitPaneUI newUI)
          Sets the SplitPaneUI that is using the receiver.
 void setBorder(Border border)
          Sets the border of this component.
 void setDividerSize(int newSize)
          Sets the size of the divider to newSize.
protected  void setMouseOver(boolean mouseOver)
          Sets whether or not the mouse is currently over the divider.
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getListeners, getMaximumSize, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

ONE_TOUCH_SIZE

protected static final int ONE_TOUCH_SIZE
Class is disabled.

Width or height of the divider based on orientation BasicSplitPaneUI adds two to this.

See Also:
Constant Field Values

ONE_TOUCH_OFFSET

protected static final int ONE_TOUCH_OFFSET
Class is disabled.

See Also:
Constant Field Values

dragger

protected BasicSplitPaneDivider.DragController dragger
Class is disabled.

Handles mouse dragging message to do the actual dragging.


splitPaneUI

protected BasicSplitPaneUI splitPaneUI
Class is disabled.

UI this instance was created from.


dividerSize

protected int dividerSize
Class is disabled.

Size of the divider.


hiddenDivider

protected Component hiddenDivider
Class is disabled.

Divider that is used for noncontinuous layout mode.


splitPane

protected JSplitPane splitPane
Class is disabled.

JSplitPane the receiver is contained in.


mouseHandler

protected BasicSplitPaneDivider.MouseHandler mouseHandler
Class is disabled.

Handles mouse events from both this class, and the split pane. Mouse events are handled for the splitpane since you want to be able to drag when clicking on the border of the divider, which is not drawn by the divider.


orientation

protected int orientation
Class is disabled.

Orientation of the JSplitPane.


leftButton

protected JButton leftButton
Class is disabled.

Button for quickly toggling the left component.


rightButton

protected JButton rightButton
Class is disabled.

Button for quickly toggling the right component.

Constructor Detail

BasicSplitPaneDivider

public BasicSplitPaneDivider(BasicSplitPaneUI ui)
Class is disabled.

Creates an instance of BasicSplitPaneDivider. Registers this instance for mouse events and mouse dragged events.

Method Detail

setBasicSplitPaneUI

public void setBasicSplitPaneUI(BasicSplitPaneUI newUI)
Class is disabled.

Sets the SplitPaneUI that is using the receiver.


getBasicSplitPaneUI

public BasicSplitPaneUI getBasicSplitPaneUI()
Class is disabled.

Returns the SplitPaneUI the receiver is currently in.


setDividerSize

public void setDividerSize(int newSize)
Class is disabled.

Sets the size of the divider to newSize. That is the width if the splitpane is HORIZONTAL_SPLIT, or the height of VERTICAL_SPLIT.


getDividerSize

public int getDividerSize()
Class is disabled.

Returns the size of the divider, that is the width if the splitpane is HORIZONTAL_SPLIT, or the height of VERTICAL_SPLIT.


setBorder

public void setBorder(Border border)
Class is disabled.

Sets the border of this component.

Since:
1.3

getBorder

public Border getBorder()
Class is disabled.

Returns the border of this component or null if no border is currently set.

Returns:
the border object for this component
Since:
1.3
See Also:
setBorder(javax.swing.border.Border)

getInsets

public Insets getInsets()
Class is disabled.

If a border has been set on this component, returns the border's insets, else calls super.getInsets.

Overrides:
getInsets in class Container
Returns:
the value of the insets property.
See Also:
setBorder(javax.swing.border.Border)

setMouseOver

protected void setMouseOver(boolean mouseOver)
Class is disabled.

Sets whether or not the mouse is currently over the divider.

Parameters:
mouseOver - whether or not the mouse is currently over the divider
Since:
1.5

isMouseOver

public boolean isMouseOver()
Class is disabled.

Returns whether or not the mouse is currently over the divider

Returns:
whether or not the mouse is currently over the divider
Since:
1.5

getPreferredSize

public Dimension getPreferredSize()
Class is disabled.

Returns dividerSize x dividerSize

Overrides:
getPreferredSize in class Container
Returns:
an instance of Dimension that represents the preferred size of this container.
See Also:
Container.getMinimumSize(), Container.getMaximumSize(), Container.getLayout(), LayoutManager.preferredLayoutSize(Container), Component.getPreferredSize()

getMinimumSize

public Dimension getMinimumSize()
Class is disabled.

Returns dividerSize x dividerSize

Overrides:
getMinimumSize in class Container
Returns:
an instance of Dimension that represents the minimum size of this container.
See Also:
Container.getPreferredSize(), Container.getMaximumSize(), Container.getLayout(), LayoutManager.minimumLayoutSize(Container), Component.getMinimumSize()

propertyChange

public void propertyChange(PropertyChangeEvent e)
Class is disabled.

Property change event, presumably from the JSplitPane, will message updateOrientation if necessary.

Specified by:
propertyChange in interface PropertyChangeListener
Parameters:
e - A PropertyChangeEvent object describing the event source and the property that has changed.

paint

public void paint(Graphics g)
Class is disabled.

Paints the divider.

Overrides:
paint in class Container
Parameters:
g - the specified Graphics window
See Also:
Component.update(Graphics)

oneTouchExpandableChanged

protected void oneTouchExpandableChanged()
Class is disabled.

Messaged when the oneTouchExpandable value of the JSplitPane the receiver is contained in changes. Will create the leftButton and rightButton if they are null. invalidates the receiver as well.


createLeftOneTouchButton

protected JButton createLeftOneTouchButton()
Class is disabled.

Creates and return an instance of JButton that can be used to collapse the left component in the split pane.


createRightOneTouchButton

protected JButton createRightOneTouchButton()
Class is disabled.

Creates and return an instance of JButton that can be used to collapse the right component in the split pane.


prepareForDragging

protected void prepareForDragging()
Class is disabled.

Message to prepare for dragging. This messages the BasicSplitPaneUI with startDragging.


dragDividerTo

protected void dragDividerTo(int location)
Class is disabled.

Messages the BasicSplitPaneUI with dragDividerTo that this instance is contained in.


finishDraggingTo

protected void finishDraggingTo(int location)
Class is disabled.

Messages the BasicSplitPaneUI with finishDraggingTo that this instance is contained in.