Java Swing-JSplitPane

Java Swing 提供了一种组件 - JSplitPane ，它可以被用来分割一个容器中的两个组件。一个组件可以拖动垂直或水平方向来改变两个组件之间的分界线位置。JSplitPane 是一个常用的布局方式，因为它提供了一个简单、方便的界面来通过一个鼠标拖动来设置将一个 UI 分割成两个部分。

如何使用JSplitPane

JSplitPane类是继承自JComponent类的。创建一个 JSplitPane，您必须先确定方向，然后在两个组件之间设置分割线位置。

构造函数

JSplitPane类具有两个构造函数:

JSplitPane() // Creates split with two empty panes horizontally split. 
JSplitPane(int newOrientation) // Creates split with two empty panes either horizontally or vertically split.

示例代码：

JSplitPane splitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT);

在该构造函数中，我们创建了一个横向分割的 JSplitPane 实例。

设置组件

从上面的示例代码中，我们可以看到，在创建实例后，我们需要使用方法设置其它组件。

void setLeftComponent(Component leftComponent)
void setRightComponent(Component rightComponent)

示例代码：

JPanel leftPanel = new JPanel();
JPanel rightPanel = new JPanel();
JSplitPane splitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT);

splitPane.setLeftComponent(leftPanel);
splitPane.setRightComponent(rightPanel);

在这个示例中，我们使用 setLeftComponent() 和 setRightComponent() 方法将两个面板添加至分割栏中。

设置分割线位置

我们可以使用以下方法在没有鼠标交互的情况下设置分割线位置。

void setDividerLocation(int location) // Sets the divider location to a specific value.

该方法接收一个参数，表示分割线的位置。

splitPane.setDividerLocation(150);

在上面这个示例中，我们将分割线的位置设置为 150。这个位置表示为第二个组件的起始位置。

JSplitPane常用方法

• setDividerSize(int size)：设置分隔线的大小；
• setDividerLocation(double ratio)：调整两部分的比例，ratio 是0-1之间的小数；
• setResizeWeight(double value)：设置组件的分配重量，以确定 JSplitPane 的大小重分配；
• setContinuousLayout(boolean newContinuousLayout)：设置为 true 时，我们在分拆窗格时可以使用 splitpane 的所有空间 flexibly；
• setOneTouchExpandable(boolean newValue)：设置为 True时，拆分窗格框架将显示箭头按钮，以便快速展开和关闭组件；
• setLeftComponent(Component component)：将部件添加到拆分窗格的左侧（对于水平拆分）或顶部（对于垂直拆分）；
• setRightComponent(Component component)：将组件添加到拆分窗格的右侧（对于水平拆分）或底部（对于垂直拆分）；
• setOrientation(int orientation)：水平拆分或垂直拆分；

示例代码

下面是一个使用 JSplitPane 实现的示例代码。

import javax.swing.*;
import java.awt.*;

public class DemoSplitPane extends JFrame {

    public DemoSplitPane() {
        //创建两个JPanel
        JPanel leftPanel = new JPanel();
        JPanel rightPanel = new JPanel();

        //左侧添加JButton组件
        JButton btnLeft = new JButton("Click me from left");
        leftPanel.add(btnLeft);

        //右侧添加JLabel组件
        JLabel labelRight = new JLabel("This is right panel");
        rightPanel.add(labelRight);

        //创建拆分窗格
        JSplitPane splitPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT);

        //设置左右两个面板
        splitPane.setLeftComponent(leftPanel);
        splitPane.setRightComponent(rightPanel);

        //设置分割线位置
        splitPane.setOneTouchExpandable(true);
        splitPane.setDividerLocation(150);

        //将拆分窗格添加到主窗口
        getContentPane().add(splitPane);
        setSize(400, 350);
        setVisible(true);
    }

    public static void main(String[] args) {
        DemoSplitPane demoSplitPane = new DemoSplitPane();
    }
}

总结

本文介绍了如何使用 JSplitPane 来分割一个容器中的两个组件，并介绍了 JSplitPane 中的常用方法。它提供了一个简单、方便的界面来通过一个鼠标拖动来设置将一个 UI 分割成两个部分，是一个常用的布局方式。