Package Summary  Overview Summary

class:JSplitPane [NONE]
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible
@JavaBean(defaultProperty="UI") public class JSplitPaneextends 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.

Warning: Swing is not thread safe. For more information see Swing's Threading Policy .

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

Since:
1.2
See Also:

field:VERTICAL_SPLIT [NONE]

  • VERTICAL_SPLIT

    public static final  int VERTICAL_SPLIT
    Vertical split indicates the Components are split along the y axis. For example the two Components will be split one on top of the other.
    See Also:

    • field:HORIZONTAL_SPLIT [NONE]

    HORIZONTAL_SPLIT

    public static final  int HORIZONTAL_SPLIT
    Horizontal split indicates the Components are split along the x axis. For example the two Components will be split one to the left of the other.
    See Also:

    field:LEFT [NONE]

    LEFT

    public static final  String LEFT
    Used to add a Component to the left of the other Component.
    See Also:

    field:RIGHT [NONE]

    field:TOP [NONE]

    TOP

    public static final  String TOP
    Used to add a Component above the other Component.
    See Also:

    field:BOTTOM [NONE]

    BOTTOM

    public static final  String BOTTOM
    Used to add a Component below the other Component.
    See Also:

    field:DIVIDER [NONE]

    DIVIDER

    public static final  String DIVIDER
    Used to add a Component that will represent the divider.
    See Also:

    field:ORIENTATION_PROPERTY [NONE]

    ORIENTATION_PROPERTY

    public static final  String ORIENTATION_PROPERTY
    Bound property name for orientation (horizontal or vertical).
    See Also:

    field:CONTINUOUS_LAYOUT_PROPERTY [NONE]

    CONTINUOUS_LAYOUT_PROPERTY

    public static final  String CONTINUOUS_LAYOUT_PROPERTY
    Bound property name for continuousLayout.
    See Also:

    field:DIVIDER_SIZE_PROPERTY [NONE]

    DIVIDER_SIZE_PROPERTY

    public static final  String DIVIDER_SIZE_PROPERTY
    Bound property name for border.
    See Also:

    field:ONE_TOUCH_EXPANDABLE_PROPERTY [NONE]

    ONE_TOUCH_EXPANDABLE_PROPERTY

    public static final  String ONE_TOUCH_EXPANDABLE_PROPERTY
    Bound property for oneTouchExpandable.
    See Also:

    field:LAST_DIVIDER_LOCATION_PROPERTY [NONE]

    LAST_DIVIDER_LOCATION_PROPERTY

    public static final  String LAST_DIVIDER_LOCATION_PROPERTY
    Bound property for lastLocation.
    See Also:

    field:DIVIDER_LOCATION_PROPERTY [NONE]

    DIVIDER_LOCATION_PROPERTY

    public static final  String DIVIDER_LOCATION_PROPERTY
    Bound property for the dividerLocation.
    Since:
    1.3
    See Also:

    field:RESIZE_WEIGHT_PROPERTY [NONE]

    RESIZE_WEIGHT_PROPERTY

    public static final  String RESIZE_WEIGHT_PROPERTY
    Bound property for weight.
    Since:
    1.3
    See Also:

    field:orientation [NONE]

    orientation

    protected int orientation
    How the views are split.

    field:continuousLayout [NONE]

    continuousLayout

    protected boolean continuousLayout
    Whether or not the views are continuously redisplayed while resizing.

    field:leftComponent [NONE]

    leftComponent

    protected Component leftComponent
    The left or top component.

    field:rightComponent [NONE]

    rightComponent

    protected Component rightComponent
    The right or bottom component.

    field:dividerSize [NONE]

    dividerSize

    protected int dividerSize
    Size of the divider.

    field:oneTouchExpandable [NONE]

    oneTouchExpandable

    protected boolean oneTouchExpandable
    Is a little widget provided to quickly expand/collapse the split pane?

    field:lastDividerLocation [NONE]

    lastDividerLocation

    protected int lastDividerLocation
    Previous location of the split pane.

    constructor:JSplitPane() [NONE]

  • JSplitPane

    public JSplitPane()
    Creates a new JSplitPane configured to arrange the child components side-by-side horizontally, using two buttons for the components.

    • constructor:JSplitPane(int) [NONE]

    JSplitPane

    @ConstructorProperties("orientation") public JSplitPane (int newOrientation)
    Creates a new JSplitPane configured with the specified orientation.
    Parameters:
    newOrientation - JSplitPane.HORIZONTAL_SPLIT or JSplitPane.VERTICAL_SPLIT
    Throws:
    IllegalArgumentException - if orientation is not one of HORIZONTAL_SPLIT or VERTICAL_SPLIT.

    constructor:JSplitPane(int,boolean) [NONE]

    JSplitPane

    public JSplitPane (int newOrientation, boolean newContinuousLayout)
    Creates a new JSplitPane with the specified orientation and redrawing style.
    Parameters:
    newOrientation - JSplitPane.HORIZONTAL_SPLIT or JSplitPane.VERTICAL_SPLIT
    newContinuousLayout - a boolean, true for the components to redraw continuously as the divider changes position, false to wait until the divider position stops changing to redraw
    Throws:
    IllegalArgumentException - if orientation is not one of HORIZONTAL_SPLIT or VERTICAL_SPLIT

    constructor:JSplitPane(int,java.awt.Component,java.awt.Component) [NONE]

    JSplitPane

    public JSplitPane (int newOrientation, Component newLeftComponent, Component newRightComponent)
    Creates a new JSplitPane with the specified orientation and the specified components.
    Parameters:
    newOrientation - JSplitPane.HORIZONTAL_SPLIT or JSplitPane.VERTICAL_SPLIT
    newLeftComponent - the Component that will appear on the left of a horizontally-split pane, or at the top of a vertically-split pane
    newRightComponent - the Component that will appear on the right of a horizontally-split pane, or at the bottom of a vertically-split pane
    Throws:
    IllegalArgumentException - if orientation is not one of: HORIZONTAL_SPLIT or VERTICAL_SPLIT

    constructor:JSplitPane(int,boolean,java.awt.Component,java.awt.Component) [NONE]

    JSplitPane

    public 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.
    Parameters:
    newOrientation - JSplitPane.HORIZONTAL_SPLIT or JSplitPane.VERTICAL_SPLIT
    newContinuousLayout - a boolean, true for the components to redraw continuously as the divider changes position, false to wait until the divider position stops changing to redraw
    newLeftComponent - the Component that will appear on the left of a horizontally-split pane, or at the top of a vertically-split pane
    newRightComponent - the Component that will appear on the right of a horizontally-split pane, or at the bottom of a vertically-split pane
    Throws:
    IllegalArgumentException - if orientation is not one of HORIZONTAL_SPLIT or VERTICAL_SPLIT

    method:setUI(javax.swing.plaf.SplitPaneUI) [NONE]

  • setUI

    public void setUI (SplitPaneUI ui)
    Sets the L&F object that renders this component.
    Parameters:
    ui - the SplitPaneUI L&F object
    See Also:

    • method:getUI() [NONE]

    getUI

    @BeanProperty(bound=false, expert=true, description="The L&F object that renders this component.") public SplitPaneUI getUI()
    Returns the SplitPaneUI that is providing the current look and feel.
    Overrides:
    getUI in class JComponent
    Returns:
    the SplitPaneUI object that renders this component

    method:updateUI() [NONE]

    updateUI

    public void updateUI()
    Notification from the UIManager that the L&F has changed. Replaces the current UI object with the latest version from the UIManager.
    Overrides:
    updateUI in class JComponent
    See Also:

    method:getUIClassID() [NONE]

    getUIClassID

    @BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class.") public String getUIClassID()
    Returns the name of the L&F class that renders this component.
    Overrides:
    getUIClassID in class JComponent
    Returns:
    the string "SplitPaneUI"
    See Also:

    method:setDividerSize(int) [CHANGED]

    setDividerSize

    @BeanProperty(description="The size of the divider.") public void setDividerSize (int newSize)
    Sets the size of the divider. Divider sizes newSize < 0 are ignored.
    Parameters:
    newSize - an integer giving the size of the divider in pixels

    setDividerSize

    @BeanProperty(description="The size of the divider.") public void setDividerSize (int newSize)
    Sets the size of the divider.
    Parameters:
    newSize - an integer giving the size of the divider in pixels

    setDividerSize

    @BeanProperty(description="The size of the divider.") public void setDividerSize (int newSize)
    Sets the size of the divider. Divider sizes newSize < 0 are ignored.
    Parameters:
    newSize - an integer giving the size of the divider in pixels

    method:getDividerSize() [NONE]

    getDividerSize

    public int getDividerSize()
    Returns the size of the divider.
    Returns:
    an integer giving the size of the divider in pixels

    method:setLeftComponent(java.awt.Component) [NONE]

    setLeftComponent

    public void setLeftComponent (Component comp)
    Sets the component to the left (or above) the divider.
    Parameters:
    comp - the Component to display in that position

    method:getLeftComponent() [NONE]

    getLeftComponent

    @BeanProperty(bound=false, preferred=true, description="The component to the left (or above) the divider.") public Component getLeftComponent()
    Returns the component to the left (or above) the divider.
    Returns:
    the Component displayed in that position

    method:setTopComponent(java.awt.Component) [NONE]

    setTopComponent

    @BeanProperty(bound=false, description="The component above, or to the left of the divider.") public void setTopComponent (Component comp)
    Sets the component above, or to the left of the divider.
    Parameters:
    comp - the Component to display in that position

    method:getTopComponent() [NONE]

    getTopComponent

    public Component getTopComponent()
    Returns the component above, or to the left of the divider.
    Returns:
    the Component displayed in that position

    method:setRightComponent(java.awt.Component) [NONE]

    setRightComponent

    @BeanProperty(bound=false, preferred=true, description="The component to the right (or below) the divider.") public void setRightComponent (Component comp)
    Sets the component to the right (or below) the divider.
    Parameters:
    comp - the Component to display in that position

    method:getRightComponent() [NONE]

    getRightComponent

    public Component getRightComponent()
    Returns the component to the right (or below) the divider.
    Returns:
    the Component displayed in that position

    method:setBottomComponent(java.awt.Component) [NONE]

    setBottomComponent

    @BeanProperty(bound=false, description="The component below, or to the right of the divider.") public void setBottomComponent (Component comp)
    Sets the component below, or to the right of the divider.
    Parameters:
    comp - the Component to display in that position

    method:getBottomComponent() [NONE]

    getBottomComponent

    public Component getBottomComponent()
    Returns the component below, or to the right of the divider.
    Returns:
    the Component displayed in that position

    method:setOneTouchExpandable(boolean) [NONE]

    setOneTouchExpandable

    @BeanProperty(description="UI widget on the divider to quickly expand/collapse the divider.") public 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. The default value of this property is false. Some look and feels might not support one-touch expanding; they will ignore this property.
    Parameters:
    newValue - true to specify that the split pane should provide a collapse/expand widget
    See Also:

    method:isOneTouchExpandable() [NONE]

    isOneTouchExpandable

    public boolean isOneTouchExpandable()
    Gets the oneTouchExpandable property.
    Returns:
    the value of the oneTouchExpandable property
    See Also:

    method:setLastDividerLocation(int) [NONE]

    setLastDividerLocation

    @BeanProperty(description="The last location the divider was at.") public void setLastDividerLocation (int newLastLocation)
    Sets the last location the divider was at to newLastLocation.
    Parameters:
    newLastLocation - an integer specifying the last divider location in pixels, from the left (or upper) edge of the pane to the left (or upper) edge of the divider

    method:getLastDividerLocation() [NONE]

    getLastDividerLocation

    public int getLastDividerLocation()
    Returns the last location the divider was at.
    Returns:
    an integer specifying the last divider location as a count of pixels from the left (or upper) edge of the pane to the left (or upper) edge of the divider

    method:setOrientation(int) [NONE]

    setOrientation

    @BeanProperty(enumerationValues={"JSplitPane.HORIZONTAL_SPLIT","JSplitPane.VERTICAL_SPLIT"}, description="The orientation, or how the splitter is divided.") public void setOrientation (int orientation)
    Sets the orientation, or how the splitter is divided. The options are:
    • JSplitPane.VERTICAL_SPLIT (above/below orientation of components)
    • JSplitPane.HORIZONTAL_SPLIT (left/right orientation of components)
    Parameters:
    orientation - an integer specifying the orientation
    Throws:
    IllegalArgumentException - if orientation is not one of: HORIZONTAL_SPLIT or VERTICAL_SPLIT.

    method:getOrientation() [NONE]

    getOrientation

    public int getOrientation()
    Returns the orientation.
    Returns:
    an integer giving the orientation
    See Also:

    method:setContinuousLayout(boolean) [NONE]

    setContinuousLayout

    @BeanProperty(description="Whether the child components are continuously redisplayed and laid out during user intervention.") public 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. The default value of this property is look and feel dependent. Some look and feels might not support continuous layout; they will ignore this property.
    Parameters:
    newContinuousLayout - true if the components should continuously be redrawn as the divider changes position
    See Also:

    method:isContinuousLayout() [NONE]

    isContinuousLayout

    public boolean isContinuousLayout()
    Gets the continuousLayout property.
    Returns:
    the value of the continuousLayout property
    See Also:

    method:setResizeWeight(double) [NONE]

    setResizeWeight

    @BeanProperty(description="Specifies how to distribute extra space when the split pane resizes.") public void setResizeWeight (double value)
    Specifies how to distribute extra space when the size of the split pane changes. A value of 0, the default, indicates the right/bottom component gets all the extra space (the left/top component acts fixed), where as a value of 1 specifies the left/top component gets all the extra space (the right/bottom component acts fixed). Specifically, the left/top component gets (weight * diff) extra space and the right/bottom component gets (1 - weight) * diff extra space.
    Parameters:
    value - as described above
    Throws:
    IllegalArgumentException - if value is < 0 or > 1
    Since:
    1.3

    method:getResizeWeight() [NONE]

    getResizeWeight

    public double getResizeWeight()
    Returns the number that determines how extra space is distributed.
    Returns:
    how extra space is to be distributed on a resize of the split pane
    Since:
    1.3

    method:resetToPreferredSizes() [NONE]

    resetToPreferredSizes

    public void resetToPreferredSizes()
    Lays out the JSplitPane layout based on the preferred size of the children components. This will likely result in changing the divider location.

    method:setDividerLocation(double) [NONE]

    setDividerLocation

    @BeanProperty(description="The location of the divider.") public void setDividerLocation (double proportionalLocation)
    Sets the divider location as a percentage of the JSplitPane's size.

    This method is implemented in terms of setDividerLocation(int). This method immediately changes the size of the split pane based on its current size. If the split pane is not correctly realized and on screen, this method will have no effect (new divider location will become (current size * proportionalLocation) which is 0).

    Parameters:
    proportionalLocation - a double-precision floating point value that specifies a percentage, from zero (top/left) to 1.0 (bottom/right)
    Throws:
    IllegalArgumentException - if the specified location is < 0 or > 1.0

    method:setDividerLocation(int) [NONE]

    setDividerLocation

    @BeanProperty(description="The location of the divider.") public void setDividerLocation (int location)
    Sets the location of the divider. This is passed off to the look and feel implementation, and then listeners are notified. A value less than 0 implies the divider should be reset to a value that attempts to honor the preferred size of the left/top component. After notifying the listeners, the last divider location is updated, via setLastDividerLocation.
    Parameters:
    location - an int specifying a UI-specific value (typically a pixel count)

    method:getDividerLocation() [NONE]

    getDividerLocation

    public int getDividerLocation()
    Returns the last value passed to setDividerLocation. The value returned from this method may differ from the actual divider location (if setDividerLocation was passed a value bigger than the current size).
    Returns:
    an integer specifying the location of the divider

    method:getMinimumDividerLocation() [NONE]

    getMinimumDividerLocation

    @BeanProperty(bound=false, description="The minimum location of the divider from the L&F.") public int getMinimumDividerLocation()
    Returns the minimum location of the divider from the look and feel implementation.
    Returns:
    an integer specifying a UI-specific value for the minimum location (typically a pixel count); or -1 if the UI is null

    method:getMaximumDividerLocation() [NONE]

    getMaximumDividerLocation

    @BeanProperty(bound=false) public int getMaximumDividerLocation()
    Returns the maximum location of the divider from the look and feel implementation.
    Returns:
    an integer specifying a UI-specific value for the maximum location (typically a pixel count); or -1 if the UI is null

    method:remove(java.awt.Component) [NONE]

    remove

    public void remove (Component component)
    Removes the child component, component from the pane. Resets the leftComponent or rightComponent instance variable, as necessary.
    Overrides:
    remove in class Container
    Parameters:
    component - the Component to remove
    See Also:

    method:remove(int) [NONE]

    remove

    public void remove (int index)
    Removes the Component at the specified index. Updates the leftComponent and rightComponent instance variables as necessary, and then messages super.
    Overrides:
    remove in class Container
    Parameters:
    index - an integer specifying the component to remove, where 1 specifies the left/top component and 2 specifies the bottom/right component
    See Also:

    method:removeAll() [NONE]

    removeAll

    public void removeAll()
    Removes all the child components from the split pane. Resets the leftComonent and rightComponent instance variables.
    Overrides:
    removeAll in class Container
    See Also:

    method:isValidateRoot() [NONE]

    isValidateRoot

    @BeanProperty(hidden=true) public 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.
    Overrides:
    isValidateRoot in class JComponent
    Returns:
    true
    See Also:

    method:addImpl(java.awt.Component,java.lang.Object,int) [NONE]

    addImpl

    protected void addImpl (Component comp, Object constraints, int index)
    Adds the specified component to this split pane. If constraints identifies the left/top or right/bottom child component, and a component with that identifier was previously added, it will be removed and then comp will be added in its place. If constraints is not one of the known identifiers the layout manager may throw an IllegalArgumentException.

    The possible constraints objects (Strings) are:

    • JSplitPane.TOP
    • JSplitPane.LEFT
    • JSplitPane.BOTTOM
    • JSplitPane.RIGHT
    If the constraints object is null, the component is added in the first available position (left/top if open, else right/bottom).

    Overrides:
    addImpl in class Container
    Parameters:
    comp - the component to add
    constraints - an Object specifying the layout constraints (position) for this component
    index - an integer specifying the index in the container's list.
    Throws:
    IllegalArgumentException - if the constraints object does not match an existing component
    See Also:

    method:paintChildren(java.awt.Graphics) [NONE]

    paintChildren

    protected void paintChildren (Graphics g)
    Subclassed to message the UI with finishedPaintingChildren after super has been messaged, as well as painting the border.
    Overrides:
    paintChildren in class JComponent
    Parameters:
    g - the Graphics context within which to paint
    See Also:

    method:paramString() [NONE]

    paramString

    protected String paramString()
    Returns a string representation of this JSplitPane. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.
    Overrides:
    paramString in class JComponent
    Returns:
    a string representation of this JSplitPane.

    method:getAccessibleContext() [NONE]

    getAccessibleContext

    @BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this SplitPane.") public AccessibleContext getAccessibleContext()
    Gets the AccessibleContext associated with this JSplitPane. For split panes, the AccessibleContext takes the form of an AccessibleJSplitPane. A new AccessibleJSplitPane instance is created if necessary.
    Specified by:
    getAccessibleContext in interface Accessible
    Overrides:
    getAccessibleContext in class Component
    Returns:
    an AccessibleJSplitPane that serves as the AccessibleContext of this JSplitPane

    © 2023 Oracle Corporation and/or its affiliates