Java中java.awt.GridBagLayout的常量字段值

一、GridBagLayout 类基本知识

1、GridBagLayout的继承关系

java.lang.Object

java.awt.GridBagLayout

所有已实现的接口：

LayoutManager, LayoutManager2, Serializable

 

2、GridBagLayout 类简介

GridBagLayout 类是一个灵活的布局管理器，它不要求组件的大小相同便可以将组件垂直、水平或沿它们的基线对齐。每个 GridBagLayout 对象维持一个动态的矩形单元网格，每个组件占用一个或多个这样的单元，该单元被称为显示区域。

每个由 GridBagLayout 管理的组件都与 GridBagConstraints 的实例相关联。Constraints 对象指定组件的显示区域在网格中的具体放置位置，以及组件在其显示区域中的放置方式。除了 Constraints 对象之外，GridBagLayout 还考虑每个组件的最小大小和首选大小，以确定组件的大小。

网格的总体方向取决于容器的 ComponentOrientation 属性。对于水平的从左到右的方向，网格坐标 (0,0) 位于容器的左上角，其中 X 向右递增，Y 向下递增。对于水平的从右到左的方向，网格坐标 (0,0) 位于容器的右上角，其中 X 向左递增，Y 向下递增。

为了有效使用网格包布局，必须自定义与组件关联的一个或多个 GridBagConstraints 对象。可以通过设置一个或多个实例变量来自定义 GridBagConstraints 对象：

GridBagConstraints.gridx、GridBagConstraints.gridy

    指定包含组件显示区域的前导角的单元，在此显示区域中，位于网格原点的单元地址是 gridx = 0, gridy = 0。对于水平的从左到右的布局，组件的前导角是其左上角。对于水平的从右到左的布局，组件的前导角是其右上角。使用 GridBagConstraints.RELATIVE（默认值），指定会将组件直接放置在之前刚添加到容器中的组件的后面（沿 X 轴向为 gridx 或 Y 轴向为 gridy）。

GridBagConstraints.gridwidth、GridBagConstraints.gridheight

    指定组件的显示区域中行（针对 gridwidth）或列（针对 gridheight）中的单元数。默认值为 1。使用 GridBagConstraints.REMAINDER 指定组件的显示区域，该区域的范围是从 gridx 到该行（针对 gridwidth）中的最后一个单元，或者从 gridy 到该列（针对 gridheight）中的最后一个单元。 使用 GridBagConstraints.RELATIVE 指定组件的显示区域，该区域的范围是从 gridx   到其所在行（针对 gridwidth）的倒数第二个单元，或者从 gridy 到其所在列（针对 gridheight）的倒数第二个单元。

GridBagConstraints.fill

    当组件的显示区域大于组件的所需大小时，用于确定是否（以及如何）调整组件。可能的值为 GridBagConstraints.NONE（默认值）、GridBagConstraints.HORIZONTAL（加宽组件直到它足以在水平方向上填满其显示区域，但不更改其高度）、GridBagConstraints.VERTICAL（加高组件直到它足以在垂直方向上填满其显示区域，但不更改其宽度）和 GridBagConstraints.BOTH（使组件完全填满其显示区域）。

GridBagConstraints.ipadx、GridBagConstraints.ipady

    指定布局中组件的内部填充，即对组件最小大小的添加量。组件的宽度至少为其最小宽度加上 ipadx 像素。类似地，组件的高度至少为其最小高度加上 ipady 像素。

GridBagConstraints.insets

    指定组件的外部填充，即组件与其显示区域边缘之间间距的最小量。

GridBagConstraints.anchor

指定组件应置于其显示区域中何处。可能的值有三种：绝对值、相对于方向的值和相对于基线的值。相对于方向的值是相对于容器的 ComponentOrientation 属性进行解释的，而绝对值则不然。相关于基线的值是相对于基线进行计算的。

 

二、示例

GridBagLayout和GridBagConstraints布局十个按钮的具体用法：

import java.awt.*;

import java.util.*;

import java.applet.Applet;

 

public class GridBagEx1 extends Applet {

     protected void makebutton(String name,

                               GridBagLayout gridbag,

                               GridBagConstraints c) {

         Button button = new Button(name);

         gridbag.setConstraints(button, c);

         add(button);

     }

 

     public void init() {

         GridBagLayout gridbag = new GridBagLayout();

         GridBagConstraints c = new GridBagConstraints();

 

         setFont(new Font("SansSerif", Font.PLAIN, 14));

         setLayout(gridbag);

 

         c.fill = GridBagConstraints.BOTH;

         c.weightx = 1.0;

         makebutton("Button1", gridbag, c);

         makebutton("Button2", gridbag, c);

         makebutton("Button3", gridbag, c);

 

           c.gridwidth = GridBagConstraints.REMAINDER; //end row

         makebutton("Button4", gridbag, c);

 

         c.weightx = 0.0;                  //reset to the default

         makebutton("Button5", gridbag, c); //another row

 

           c.gridwidth = GridBagConstraints.RELATIVE; //next-to-last in row

         makebutton("Button6", gridbag, c);

 

           c.gridwidth = GridBagConstraints.REMAINDER; //end row

         makebutton("Button7", gridbag, c);

 

           c.gridwidth = 1;                //reset to the default

           c.gridheight = 2;

         c.weighty = 1.0;

         makebutton("Button8", gridbag, c);

 

         c.weighty = 0.0;                  //reset to the default

           c.gridwidth = GridBagConstraints.REMAINDER; //end row

           c.gridheight = 1;               //reset to the default

         makebutton("Button9", gridbag, c);

         makebutton("Button10", gridbag, c);

 

         setSize(300, 100);

     }

 

     public static void main(String args[]) {

           Frame f = new Frame("GridBag Layout Example");

           GridBagEx1 ex1 = new GridBagEx1();

 

           ex1.init();

 

           f.add("Center", ex1);

           f.pack();

           f.setSize(f.getPreferredSize());

           f.show();

     }

}

 

三、以下介绍GridBagLayout的常量字段值用法：

MAXGRIDSIZE

此字段不再用于保留数组和保持向后兼容性。以前，此是网格包布局布置的网格位置（既包括水平的位置，也包括垂直的位置）的最大数。当前实现不会对网格大小产生任何影响。

 

MINSIZE

网格包布局可以布置的最小网格。

 

PREFERREDSIZE

网格包布局可以布置的首选网格大小。

 

四、GridBagLayout的常量字段值定义：

java.awt.GridBagLayout
protected static final int	MAXGRIDSIZE	512
protected static final int	MINSIZE	1
protected static final int	PREFERREDSIZE	2