GridBagLayout(转)

May 5, 2007

Gridx——组件的横向坐标
Girdy——组件的纵向坐标
Gridwidth——组件的横向宽度,也就是指组件占用的列数,这与HTML的colspan类似
Gridheight——组件的纵向长度,也就是指组件占用的行数,这与HTML的rowspan类似
Weightx——指行的权重,告诉布局管理器如何分配额外的水平空间
Weighty——指列的权重,告诉布局管理器如何分配额外的垂直空间
Anchor——告诉布局管理器组件在表格空间中的位置
Fill——如果显示区域比组件的区域大的时候,可以用来控制组件的行为。控制组件是垂直填充,还是水平填充,或者两个方向一起填充
Insets——指组件与表格空间四周边缘的空白区域的大小
Ipadx—— 组件间的横向间距,组件的宽度就是这个组件的最小宽度加上ipadx值
ipady—— 组件间的纵向间距,组件的高度就是这个组件的最小高度加上ipady值

public class GridBagLayoutextends Objectimplements LayoutManager2, SerializableGridBagLayout 类是一个灵活的布局管理器,它不要求组件的大小相同便可以将组件垂直、水平或沿它们的基线对齐。每个 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 属性进行解释的,而绝对值则不然。相关于基线的值是相对于基线进行计算的。有效值包括:

绝对值
相对于方向的值
相对于基线的值

GridBagConstraints.NORTH
GridBagConstraints.SOUTH
GridBagConstraints.WEST
GridBagConstraints.EAST
GridBagConstraints.NORTHWEST
GridBagConstraints.NORTHEAST
GridBagConstraints.SOUTHWEST
GridBagConstraints.SOUTHEAST
GridBagConstraints.CENTER(默认值)
GridBagConstraints.PAGE_START
GridBagConstraints.PAGE_END
GridBagConstraints.LINE_START
GridBagConstraints.LINE_END
GridBagConstraints.FIRST_LINE_START
GridBagConstraints.FIRST_LINE_END
GridBagConstraints.LAST_LINE_START
GridBagConstraints.LAST_LINE_END
GridBagConstraints.BASELINE
GridBagConstraints.BASELINE_LEADING
GridBagConstraints.BASELINE_TRAILING
GridBagConstraints.ABOVE_BASELINE
GridBagConstraints.ABOVE_BASELINE_LEADING
GridBagConstraints.ABOVE_BASELINE_TRAILING
GridBagConstraints.BELOW_BASELINE
GridBagConstraints.BELOW_BASELINE_LEADING
GridBagConstraints.BELOW_BASELINE_TRAILING

GridBagConstraints.weightx、GridBagConstraints.weighty
用于确定分布空间的方式,这对于指定调整行为至关重要。除非在行 (weightx) 和列 (weighty) 中至少指定一个组件的权重,否则所有组件都会聚集在其容器的中央。这是因为,当权重为零(默认值)时,GridBagLayout 对象会将所有额外空间置于其单元网格和容器边缘之间。
每行可以有一条基线,具体取决于该行中具有有效基线并沿此基线对齐的组件(组件的锚值是 BASELINE、BASELINE_LEADING 或 BASELINE_TRAILING 其中之一)。如果行中没有具有有效基线的组件,则该行没有基线。

如果组件跨多行,则它与起始行(如果基线调整行为是 CONSTANT_ASCENT)或结束行(如果基线调整行为是 CONSTANT_DESCENT)的基线对齐。用来对齐组件的行称为主导行。

下图显示了基线布局并包括横跨行的组件:

此布局由三个组件组成:
起始于 0 行并结束于 1 行的面板。该面板有一个 CONSTANT_DESCENT 基线调整行为以及 BASELINE 的锚。因为基线调整行为是 CONSTANT_DESCENT,所以该面板的主要行是第 1 行。
两个按钮,每个按钮都带有 CENTER_OFFSET 基线调整行为和 BASELINE 的锚。
因为第二个按钮和面板共享相同的主要行,所以它们都沿其基线对齐。
使用一个相对于基线的值定位的组件调整不同于使用绝对值或相对于方向的值。组件更改的方式由主要行的基线更改方式指示。如果基于相同主导行的所有组件具有 CONSTANT_DESCENT 基线调整行为,则基线定位到显示区域底部;否则,基线定位到显示区域顶部。下述规则指示调整大小的行为:

位于基线上方的可调整大小的组件只能增长到与该基线一样高。例如,如果基线为 100 且位于顶部,则位于基线上方的可调整大小的组件的增长永远都不能超过 100 个单位。
同样地,位于基线下方的可调整大小的组件只能增长到和显示高度与基线之间的差值一样高。
仅当调整了大小的基线适应显示区域时,才能调整基线上具有 OTHER 基线调整行为的可调整大小组件。如果不能将基线放入显示区域,则该组件不能调整大小。
位于该基线上没有 OTHER 基线调整行为的组件只能增长到和显示高度 - 基线 + 组件基线一样高。
如果沿基线放置一个组件,但该组件没有有效的基线,那么它将在其空间中垂直居中对齐。同样地,如果已放置一个相对于基线的组件且行中的所有组件都没有有效的基线,则该组件垂直居中对齐。
下图显示了由网格包布局管理的十个组件(均为按钮)。图 2 显示水平方向从左到右的容器的布局,图 3 显示水平方向从右到左的容器的布局。

图 2:水平方向,从左到右 图 3:水平方向,从右到左

十个组件的每一个组件都会将与之相关的 GridBagConstraints 对象的 fill 字段设置为 GridBagConstraints.BOTH。此外,这些组件还具有以下非默认值约束 (Constraints):

Button1、Button2、Button3: weightx = 1.0
Button4:weightx = 1.0、gridwidth = GridBagConstraints.REMAINDER
Button5:gridwidth = GridBagConstraints.REMAINDER
Button6:gridwidth = GridBagConstraints.RELATIVE
Button7:gridwidth = GridBagConstraints.REMAINDER
Button8:gridheight = 2、weighty = 1.0
Button9、Button 10:gridwidth = GridBagConstraints.REMAINDER
下面是实现上述示例的代码:

——————————————————————————–

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();
}
}

Comments »

The URI to TrackBack this entry is: http://lwj.blogsome.com/2007/05/05/p37/trackback/

No comments yet.

RSS feed for comments on this post.

Leave a comment

Line and paragraph breaks automatic, e-mail address never displayed, HTML allowed: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <code> <em> <i> <strike> <strong>



Anti-spam measure: please retype the above text into the box provided.