javax.swing
Class JSplitPane

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JSplitPane

All Implemented Interfaces:

Accessible, ImageObserver, MenuContainer, Serializable

public class JSplitPane

extends JComponent

implements Accessible

JSplitPane is used to divide two (and only two) Components. The two Components are graphically divided based on the look and feel implementation, and the two Components can then be interactively resized by the user. Information on using JSplitPane is in How to Use Split Panes in The Java Tutorial.

The two Components in a split pane can be aligned left to right using JSplitPane.HORIZONTAL_SPLIT, or top to bottom using JSplitPane.VERTICAL_SPLIT. The preferred way to change the size of the Components is to invoke setDividerLocation where location is either the new x or y position, depending on the orientation of the JSplitPane.

To resize the Components to their preferred sizes invoke resetToPreferredSizes.

When the user is resizing the Components the minimum size of the Components is used to determine the maximum/minimum position the Components can be set to. If the minimum size of the two components is greater than the size of the split pane the divider will not allow you to resize it. To alter the minimum size of a JComponent, see JComponent.setMinimumSize(java.awt.Dimension).

When the user resizes the split pane the new space is distributed between the two components based on the resizeWeight property. A value of 0, the default, indicates the right/bottom component gets all the space, where as a value of 1 indicates the left/top component gets all the space.

For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JSplitPane key assignments.

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 JavaBeans^TM has been added to the java.beans package. Please see XMLEncoder.

See Also:

setDividerLocation(double), resetToPreferredSizes()

Nested Class Summary
protected  class	JSplitPane.AccessibleJSplitPane     This class implements accessibility support for the JSplitPane class.

 

Nested classes inherited from class javax.swing.JComponent

 

Nested classes inherited from class java.awt.Container

 

Nested classes inherited from class java.awt.Component

Component.BltBufferStrategy, Component.FlipBufferStrategy

 

Field Summary
static String	BOTTOM     Used to add a Component below the other Component.
static String	CONTINUOUS_LAYOUT_PROPERTY     Bound property name for continuousLayout.
protected  boolean	continuousLayout     Whether or not the views are continuously redisplayed while resizing.
static String	DIVIDER     Used to add a Component that will represent the divider.
static String	DIVIDER_LOCATION_PROPERTY     Bound property for the dividerLocation.
static String	DIVIDER_SIZE_PROPERTY     Bound property name for border.
protected  int	dividerSize     Size of the divider.
static int	HORIZONTAL_SPLIT     Horizontal split indicates the Components are split along the x axis.
static String	LAST_DIVIDER_LOCATION_PROPERTY     Bound property for lastLocation.
protected  int	lastDividerLocation     Previous location of the split pane.
static String	LEFT     Used to add a Component to the left of the other Component.
protected  Component	leftComponent     The left or top component.
static String	ONE_TOUCH_EXPANDABLE_PROPERTY     Bound property for oneTouchExpandable.
protected  boolean	oneTouchExpandable     Is a little widget provided to quickly expand/collapse the split pane?
protected  int	orientation     How the views are split.
static String	ORIENTATION_PROPERTY     Bound property name for orientation (horizontal or vertical).
static String	RESIZE_WEIGHT_PROPERTY     Bound property for weight.
static String	RIGHT     Used to add a Component to the right of the other Component.
protected  Component	rightComponent     The right or bottom component.
static String	TOP     Used to add a Component above the other Component.
static int	VERTICAL_SPLIT     Vertical split indicates the Components are split along the y axis.

 

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

 

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
JSplitPane()     Creates a new JSplitPane configured to arrange the child components side-by-side horizontally with no continuous layout, using two buttons for the components.
JSplitPane(int newOrientation)     Creates a new JSplitPane configured with the specified orientation and no continuous layout.
JSplitPane(int newOrientation, boolean newContinuousLayout)     Creates a new JSplitPane with the specified orientation and redrawing style.
JSplitPane(int newOrientation, boolean newContinuousLayout, Component newLeftComponent, Component newRightComponent)     Creates a new JSplitPane with the specified orientation and redrawing style, and with the specified components.
JSplitPane(int newOrientation, Component newLeftComponent, Component newRightComponent)     Creates a new JSplitPane with the specified orientation and with the specified components that do not do continuous redrawing.

 

Method Summary
protected  void	addImpl(Component comp, Object constraints, int index)     Adds the specified component to this split pane.
AccessibleContext	getAccessibleContext()     Gets the AccessibleContext associated with this JSplitPane.
Component	getBottomComponent()     Returns the component below, or to the right of the divider.
int	getDividerLocation()     Returns the last value passed to setDividerLocation.
int	getDividerSize()     Returns the size of the divider.
int	getLastDividerLocation()     Returns the last location the divider was at.
Component	getLeftComponent()     Returns the component to the left (or above) the divider.
int	getMaximumDividerLocation()     Returns the maximum location of the divider from the look and feel implementation.
int	getMinimumDividerLocation()     Returns the minimum location of the divider from the look and feel implementation.
int	getOrientation()     Returns the orientation.
double	getResizeWeight()     Returns the number that determines how extra space is distributed.
Component	getRightComponent()     Returns the component to the right (or below) the divider.
Component	getTopComponent()     Returns the component above, or to the left of the divider.
SplitPaneUI	getUI()     Returns the SplitPaneUI that is providing the current look and feel.
String	getUIClassID()     Returns the name of the L&F class that renders this component.
boolean	isContinuousLayout()     Gets the continuousLayout property.
boolean	isOneTouchExpandable()     Gets the oneTouchExpandable property.
boolean	isValidateRoot()     Returns true, so that calls to revalidate on any descendant of this JSplitPane will cause a request to be queued that will validate the JSplitPane and all its descendants.
protected  void	paintChildren(Graphics g)     Subclassed to message the UI with finishedPaintingChildren after super has been messaged, as well as painting the border.
protected  String	paramString()     Returns a string representation of this JSplitPane.
void	remove(Component component)     Removes the child component, component from the pane.
void	remove(int index)     Removes the Component at the specified index.
void	removeAll()     Removes all the child components from the split pane.
void	resetToPreferredSizes()     Lays out the JSplitPane layout based on the preferred size of the children components.
void	setBottomComponent(Component comp)     Sets the component below, or to the right of the divider.
void	setContinuousLayout(boolean newContinuousLayout)     Sets the value of the continuousLayout property, which must be true for the child components to be continuously redisplayed and laid out during user intervention.
void	setDividerLocation(double proportionalLocation)     Sets the divider location as a percentage of the JSplitPane's size.
void	setDividerLocation(int location)     Sets the location of the divider.
void	setDividerSize(int newSize)     Sets the size of the divider.
void	setLastDividerLocation(int newLastLocation)     Sets the last location the divider was at to newLastLocation.
void	setLeftComponent(Component comp)     Sets the component to the left (or above) the divider.
void	setOneTouchExpandable(boolean newValue)     Sets the value of the oneTouchExpandable property, which must be true for the JSplitPane to provide a UI widget on the divider to quickly expand/collapse the divider.
void	setOrientation(int orientation)     Sets the orientation, or how the splitter is divided.
void	setResizeWeight(double value)     Specifies how to distribute extra space when the size of the split pane changes.
void	setRightComponent(Component comp)     Sets the component to the right (or below) the divider.
void	setTopComponent(Component comp)     Sets the component above, or to the left of the divider.
void	setUI(SplitPaneUI ui)     Sets the L&F object that renders this component.
void	updateUI()     Notification from the UIManager that the L&F has changed.

 

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, paint, paintBorder, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground,