Swing-BoxLayout用法-入门

注：本文内容源于http://www.java3z.com/cwbwebhome/article/article20/200016.html?id=4797；细节内容根据笔者理解有修改。

BoxLayout 可以把控件依次进行水平或者垂直排列布局，这是通过参数 X_AXIS、Y_AXIS 来决定的。X_AXIS 表示水平排列，而 Y_AXIS 表示垂直排列。BoxLayout 的构造函数有两个参数，一个参数定义使用该 BoxLayout 的容器，另一个参数是指定 BoxLayout 是采用水平还是垂直排列。下面是一个使用 BoxLayout排列控件的例子：

JPanel panel=new JPanel();
BoxLayout layout=new BoxLayout(panel, BoxLayout.X_AXIS);
panel.setLayout(layoout);
panel.add(new JButton("hello"));
panel.add(new JButton("wolrd"));

在实际应用中，为了在控件直接添加间隔，我们常常需要分隔器，它有以下几种类型：

Rigid area 是一种用户可以定义水平和垂直尺寸的透明组件；

strut 与 rigid area 类似，但是用户只能定义一个方向的尺寸，即水平方向或者垂直方向，不能同时定义水平和垂直尺寸；

glue位于两个控件之间时，它会尽可能的占据两个控件之间的多余空间，从而将两个控件挤到两边；

Filler 是 Box 的内部类，它与 rigid area 相似，都可以指定水平或者垂直的尺寸，但是它可以设置最小，最大和优先尺寸。

下面是一个测试用例：

BoxLayoutDemo.java

import java.awt.BorderLayout;
import java.awt.Dimension;
import javax.swing.BorderFactory;
import javax.swing.Box;
import javax.swing.BoxLayout;
import javax.swing.DefaultListModel;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JList;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.ListSelectionModel;

public class BoxLayoutDemo extends JPanel {

JPanel sportPanel;
JPanel queryPanel;
JPanel middlePanel;

public BoxLayoutDemo() {
// 主面板由3个子面板组成，在水平方向排列
setLayout(new BoxLayout(this, BoxLayout.X_AXIS));
this.setSportPanel();
this.setMiddlePanel();
this.setQueryPanel();

this.add(sportPanel);
this.add(middlePanel);
this.add(queryPanel);
}

private void setSportPanel() {
System.out.println("setSportPanel called");
//本函数内包含以下两个控件
JLabel sourceLabel;//文字标签
JScrollPane sourceListScroller;//滚动条

//文字标签
sourceLabel = new JLabel("运动项目");
sourceLabel.setAlignmentY(TOP_ALIGNMENT);
sourceLabel.setBorder(BorderFactory.createEmptyBorder(4, 5, 0, 5));

// 创建一个列表，包含运动项目
DefaultListModel<String> listModel = new DefaultListModel<String>();
listModel.addElement("100米");
listModel.addElement("200米");
listModel.addElement("400米");
listModel.addElement("跳远");
listModel.addElement("跳高");
listModel.addElement("铅球");

JList<String> sourceList = new JList<String>(listModel);
sourceList
.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);
sourceList.setVisibleRowCount(5);//初始状态保持5行可见

//滚动条
sourceListScroller = new JScrollPane(sourceList);
sourceListScroller
.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
sourceListScroller.setAlignmentY(TOP_ALIGNMENT);

//开始布局主面板
sportPanel = new JPanel();
sportPanel.setLayout(new BoxLayout(sportPanel, BoxLayout.Y_AXIS));// 垂直布局
sportPanel.setBorder(BorderFactory.createBevelBorder(1));

sportPanel.add(sourceLabel);// 加入文字标签到
sportPanel.add(sourceListScroller);// 加入运动项目列表

}

private void setMiddlePanel() {
//本函数包含2个按钮
JButton toTargetButton = new JButton(">>");
JButton toSourceButton = new JButton("<<");

//布局主面板
middlePanel = new JPanel();
middlePanel.setBorder(BorderFactory.createBevelBorder(1));
middlePanel.setLayout(new BoxLayout(middlePanel, BoxLayout.Y_AXIS));//主面板为垂直布局

middlePanel.add(toTargetButton);// 添加第一个按钮>>
middlePanel.add(Box.createRigidArea(new Dimension(15, 15)));// 中间添加一个看不见的rigidArea
middlePanel.add(toSourceButton);// 添加第二个按钮<<
}

private void setQueryPanel() {

//本函数包含2个控件
JLabel targetLabel;
JScrollPane targetListScroller;

// 文字标签
targetLabel = new JLabel("查询项目");
targetLabel.setAlignmentY(TOP_ALIGNMENT);
targetLabel.setBorder(BorderFactory.createEmptyBorder(4, 5, 0, 5));

// 创建列表查询项目
DefaultListModel<String> targetListModel = new DefaultListModel<String>();
targetListModel.addElement("100米");
JList<String> targetList = new JList<String>(targetListModel);
targetList
.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);

//滚动条
targetListScroller = new JScrollPane(targetList);
targetListScroller
.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
targetListScroller.setAlignmentY(TOP_ALIGNMENT);

//设置主面板布局
queryPanel = new JPanel();
queryPanel.setLayout(new BoxLayout(queryPanel, BoxLayout.Y_AXIS));// 垂直布局
queryPanel.setBorder(BorderFactory.createBevelBorder(1));

queryPanel.add(targetLabel);//添加文字标签
queryPanel.add(targetListScroller);//添加滚动条
}

public static void main(String[] args) {
JFrame frame = new JFrame("BoxlayoutDemo");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setContentPane(new BoxLayoutDemo());
frame.pack();
// frame.repaint();
frame.setLocationRelativeTo(null);
frame.setVisible(true);
}

}

运行效果图：