The Java Developers Almanac 1.4

Home > List of Packages > javax.swing [141 examples] > JSplitPane [5 examples]

e823. Creating a JSplitPane Container

A split pane divides its space between two components. The split pane contains a divider that allows the user to control the amount of space distributed to each component.

    // Create a left-right split pane
    JSplitPane hpane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT, leftComponent, rightComponent);
    
    // Create a top-bottom split pane
    JSplitPane vpane = new JSplitPane(JSplitPane.VERTICAL_SPLIT, topComponent, bottomComponent);

By default, when the divider is dragged, a shadow is displayed to indicate where the divider would be when the mouse is released. It is possible for the split pane to continuously move the divider and resize its child components while the user is dragging the divider.

    boolean b = vpane.isContinuousLayout();  // false by default
    
    // Set the split pane to continuously resize the child components
    // which the divider is dragged
    vpane.setContinuousLayout(true);

The split pane supports a one-touch-expandable capability that allows the user to conveniently move the divider to either end with a single click. This capability is enabled by setting the following property:

    b = vpane.isOneTouchExpandable();        // false by default
    
    vpane.setOneTouchExpandable(true);

Related Examples

e824. Getting the Setting the Children in a JSplitPane Container
e825. Distributing Space When a JSplitPane Container Is Resized
e826. Getting and Setting the Divider Location in a JSplitPane Container
e827. Setting the Size of the Divider in a JSplitPane Container

See also: Actions JButton JCheckBox JComboBox JDesktop and JInternalFrame JFrame, JWindow, JDialog JLabel JList JProgressBar JRadioButton JScrollPane JSlider JSpinner JTabbedPane JToolBar Keystrokes and Input Maps Layout Look and Feel Menus Progress Monitor The Screen Tool Tips UI Default Values

© 2002 Addison-Wesley.