Swing-GridBagLayout用法-入门

注：本文内容转自：Java Layout总结-GridBagLayout。内容根据笔者理解稍有整理。

GridBagLayout布局管理器:
这就是最复杂的一个布局管理器了,网格包布局.在此布局中,组件大小不必相同.
GridBagLayout gb=new GridBagLayout(); 
ContainerName.setLayout(gb);

以上代码是让容器获得一个GridBagLayout.要使用网格包布局,还必须有其一个辅助类,GridBagContraints.它包含GridBagLayout类用来定位及调整组件大小所需要的全部信息.使用步骤如下:

1).创建网格包布局的一个实例,并将其定义为当前容器的布局管理器.

2).创建GridBagContraints的一个实例

3).为组件设置约束.

4).通过方法统治布局管理器有关组件及其约束等信息

5).将组件添加到容器.

6).对各个将被显示的组件重复以上步骤.

GridBagContraints类的成员变量列表如下:

1、gridx—组件的横向坐标；
2、girdy—组件的纵向坐标；

gridx=0,gridy=0时放在0行0列，GridBagConstraints.RELATIVE为默认值，表明当前组件紧跟在上一个组件之后。如果在行上不指定该值(同时也不指定gridx和gridy参数)，那么无论添加多少个组件都是在同一行上

3、gridwidth——组件的横向宽度，也就是指组件占用的列数，这与HTML的colspan类似；
4、gridheight—组件的纵向长度，也就是指组件占用的行数，这与HTML的rowspan类似；

设置组件横向纵向跨越多少个网格，他们的默认值都是1，如果该组件是横向或纵向的最后一个还可以将此值设为GridBagConstraints.REMAINDER，若为倒数第二个组件则可以设值为GridBagConstraints.RELATIVE。

gridwidth能否能够保留住该宽度取决于其正上/下方相应位置是否有足够的组件来占位，如果无，位置将会被压缩。比如，设置gridwidth=3，但只添加了一个JButton，这时如果其上下方相应位置没有其他组件或只有1个组件，那么它只占有1个网格大小。如果它上/下方相应位置有3个组件，那它就可以占3个网格大小了。如果它上/下方相应位置只有2个组件，那它就占2个网格大小。

gridheight能否保留住该高度取决于其左右两边是否有足够的组件来占位。也就是说它的最大高度不大于左右两边最大的高度。比如，设置gridheight=3，如果左右两边组件只有1行，则它仅仅只有1行的高度，有2行则占2行的高度。

5、weightx—指行的权重，告诉布局管理器如何分配额外的水平空间；
6、weighty—指列的权重，告诉布局管理器如何分配额外的垂直空间；

用来设置窗口变大时，各组件跟着变大的比例。当数字越大，表示组件能得到更多的空间，默认值皆为0。比如组件A的weightx=0.5，组件B的weightx=1，那么窗口X轴变大时剩余的空间就会以1：2的比例分配给组件A和B；

7、anchor—告诉布局管理器组件在表格空间中的位置,当组件小于其显示区域时使用此字段；

有CENTER(默认值)、NORTH、NORTHEAST、EAST、SOUTHEAST、WEST、NORTHWEST选择。

8、fill—如果显示区域比组件的区域大的时候，可以用来控制组件的行为。控制组件是垂直填充，还是水平填充，或者两个方向一起填充；

9、insets—指组件与表格空间四周边缘的空白区域的大小,内边距，算入组件自身大小中。它有四个参数，分别是上，左，下，右，默认为(0,0,0,0)。

10、ipadx— 组件间的横向间距，组件的宽度就是这个组件的最小宽度加上ipadx值；
11、ipady— 组件间的纵向间距，组件的高度就是这个组件的最小高度加上ipady值。

外边距，最终组件占用的大小是组件自身大小加上外边距。

下面是测试用例：

GridBagLayoutTest.java:

import java.awt.Font;
import java.awt.GridBagLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.BorderFactory;
import javax.swing.JCheckBox;
import javax.swing.JComboBox;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JTextArea;
/*
 * GridBagLayoutTest.java,source code from java核心技术 卷1 基础知识,P379
 */

public class GridBagLayoutTest {

    public static void main(String[] args) {
        // TODO Auto-generated method stub

        FontFrame frame = new FontFrame();
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setVisible(true);
    }
}

class FontFrame extends JFrame {
    int DEUAULT_WIDTH = 300;
    int DEUAULT_HEIGHT = 200;
    private JComboBox face;
    private JComboBox size;
    private JCheckBox bold;
    private JCheckBox italic;
    private JTextArea sample;

    public FontFrame() {
        setTitle("GridBagLayoutTest");
        setSize(DEUAULT_WIDTH, DEUAULT_HEIGHT);
        GridBagLayout layout = new GridBagLayout();
        setLayout(layout);

        ActionListener listener = new FontAction();
        JLabel faceLabel = new JLabel("face:");
        face = new JComboBox(new String[] { "serif", "sansSerif", "Monospaced",
                "Dialog", "DialogInput", });
        face.addActionListener(listener);

        JLabel sizeLabel = new JLabel("Size:");
        size = new JComboBox(new String[] { "8", "10", "12", "15", "18", "24",
                "36", "48" });
        size.addActionListener(listener);

        bold = new JCheckBox("Bold");
        bold.addActionListener(listener);

        italic = new JCheckBox("Italic");
        italic.addActionListener(listener);

        sample = new JTextArea();
        sample.setText("The quick brown fox jump over the lazy dog.");
        sample.setEditable(false);
        sample.setLineWrap(true);
        sample.setBorder(BorderFactory.createEtchedBorder());

        add(faceLabel, new GBC(0, 0).setAnchor(GBC.EAST));
        add(face, new GBC(1, 0).setFill(GBC.HORIZONTAL).setWeight(100, 0)
                .setInsets(1));
        add(sizeLabel, new GBC(0, 1).setAnchor(GBC.EAST));
        add(size, new GBC(1, 1).setFill(GBC.HORIZONTAL).setWeight(100, 0)
                .setInsets(1));
        add(bold, new GBC(0, 2, 2, 1).setAnchor(GBC.CENTER).setWeight(100, 100));
        add(italic,
                new GBC(0, 3, 2, 1).setAnchor(GBC.CENTER).setWeight(100, 100));
        add(sample, new GBC(2, 0, 1, 4).setFill(GBC.BOTH).setWeight(100, 100));
    }

    private class FontAction implements ActionListener {
        public void actionPerformed(ActionEvent event) {
            String fontFace = face.getSelectedItem().toString();
            int fontStyle = (bold.isSelected() ? Font.BOLD : 0)
                    + (italic.isSelected() ? Font.ITALIC : 0);
            int fontSize = Integer.parseInt(size.getSelectedItem().toString());
            Font font = new Font(fontFace, fontStyle, fontSize);
            sample.setFont(font);
            sample.repaint();
        }
    }
}

GBC.java:

import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import java.awt.Insets;

/*
 * GBC.java,source code from java核心技术 卷1 基础知识,P381
 */

public class GBC extends GridBagConstraints{
/*
 * constructs a GBC with a given gridx and gridy position and all other grid
 * bag constraint values set to the default
 * @param gridx the gridx position
 * @param gridy the gridy position
 */
    public GBC(int gridx, int gridy){
        this.gridx = gridx;
        this.gridy = gridy;
    }

    public GBC(int gridx, int gridy, int gridWidth, int gridHeight){
        this.gridx = gridx;
        this.gridy = gridy;
        this.gridwidth = gridWidth;
        this.gridheight = gridHeight;
    }

    /*
     * sets the anchor
     * @param anchor the anchor style
     * @return this object for further modification
     */

    public GBC setAnchor(int anchor){
        this.anchor = anchor;
        return this;
    }

    /*
     * sets the fill direction
     * @param fill the fill direction
     * @return this object for further modification
     */

    public GBC setFill(int fill){
        this.fill = fill;
        return this;
    }

    /*
     * sets the cell weights
     * @param weightx the cell weight in x direction
     * @param weighty the cell weight in y direction
     * @return this object for further modification
     */

    public GBC setWeight(int weightx, int weighty){
        this.weightx = weightx;
        this.weighty = weighty;
        return this;
    }

    /*
     * sets the insets of this cell
     * @param insets distance ths spacing to use in all directions
     * @return this object for further modification
     */

    public GBC setInsets(int distance){
        this.insets = new Insets(distance, distance, distance, distance);
        return this;
    }

    /*
     * sets the insets of this cell
     * @param top distance ths spacing to use on top
     * @param bottom distance ths spacing to use on bottom
     * @param left distance ths spacing to use to the left
     * @param right distance ths spacing to use to the  right
     * @return this object for further modification
     */

    public GBC setInsets(int top, int left,int bottom,int right){
        this.insets = new Insets(top, left, bottom, right);
        return this;
    }

    /*
     * sets the Ipad of this cell
     * @param Ipad distance ths spacing to use in all directions
     * @return this object for further modification
     */

    public GBC setIpad(int ipadx, int ipady){
        this.ipadx = ipadx;
        this.ipadx = ipadx;
        return this;
    }
}

运行效果图