JavaTM Platform
Standard Ed. 6

java.awt
类 GridBagConstraints

java.lang.Object
  继承者 java.awt.GridBagConstraints
所有已实现的接口:
Serializable, Cloneable

public class GridBagConstraints
     
extends Object
implements Cloneable, Serializable

GridBagConstraints 类指定使用 GridBagLayout 类布置的组件的约束。

从以下版本开始:
JDK1.0
另请参见:
GridBagLayout, 序列化表格

字段摘要
static int ABOVE_BASELINE
          anchor 字段的可能值。
static int ABOVE_BASELINE_LEADING
          anchor 字段的可能值。
static int ABOVE_BASELINE_TRAILING
          anchor 字段的可能值。
 int anchor
          当组件小于其显示区域时使用此字段。
static int BASELINE
          anchor 字段的可能值。
static int BASELINE_LEADING
          anchor 字段的可能值。
static int BASELINE_TRAILING
          anchor 字段的可能值。
static int BELOW_BASELINE
          anchor 字段的可能值。
static int BELOW_BASELINE_LEADING
          anchor 字段的可能值。
static int BELOW_BASELINE_TRAILING
          anchor 字段的可能值。
static int BOTH
          在水平方向和垂直方向上同时调整组件大小。
static int CENTER
          将组件置于其显示区域的中心。
static int EAST
          将组件置于其显示区域的右部,并在垂直方向上居中。
 int fill
          当组件的显示区域大于它所请求的显示区域的大小时使用此字段。
static int FIRST_LINE_END
          将组件置于显示区域的一角,在该区域中,当前 ComponentOrienation 的页面的第一个文本行正常结束。
static int FIRST_LINE_START
          将组件置于其显示区域的一角,这一角的位置是页面中最后一个文本行按照当前的 ComponentOrienation 在页面中的开始位置。
 int gridheight
          指定在组件显示区域的一列中的单元格数。
 int gridwidth
          指定组件显示区域的某一行中的单元格数。
 int gridx
          指定包含组件的显示区域开始边的单元格,其中行的第一个单元格为 gridx=0
 int gridy
          指定位于组件显示区域的顶部的单元格,其中最上边的单元格为 gridy=0
static int HORIZONTAL
          在水平方向而不是垂直方向上调整组件大小。
 Insets insets
          此字段指定组件的外部填充,即组件与其显示区域边缘之间间距的最小量。
 int ipadx
          此字段指定组件的内部填充,即给组件的最小宽度添加多大的空间。
 int ipady
          此字段指定内部填充,即给组件的最小高度添加多大的空间。
static int LAST_LINE_END
          将组件置于其显示区域的一角,这一角的位置是页面中最后一个文本行按照当前的 ComponentOrienation 在页面中的结束位置。
static int LAST_LINE_START
          将组件置于其显示区域的一角,这一角的位置是页面中最后一个文本行按照当前的 ComponentOrienation 在页面中的开始位置。
static int LINE_END
          沿显示区域的边缘居中放置组件,在该区域中,当前 ComponentOrienation 的文本行正常结束。
static int LINE_START
          沿显示区域的边缘居中放置组件,在该区域中,当前 ComponentOrienation 的文本行正常开始。
static int NONE
          不重新调整组件大小。
static int NORTH
          将组件置于其显示区域的顶部,并在水平方向上居中。
static int NORTHEAST
          将组件置于其显示区域的右上角。
static int NORTHWEST
          将组件置于其显示区域的左上角。
static int PAGE_END
          沿显示区域的边缘居中放置组件,该显示区域与当前 ComponentOrienation 的页面结束部分相关。
static int PAGE_START
          沿显示区域的边缘居中放置组件,该显示区域与当前 ComponentOrienation 的页面开始部分相关。
static int RELATIVE
          指定此组件为其行或列(gridwidthgridheight)中的倒数第二个组件,或者让此组件紧跟在以前添加的组件(gridxgridy)之后。
static int REMAINDER
          指定此组件是其行或列中的最后一个组件。
static int SOUTH
          将组件置于其显示区域的底部,并在水平方向上居中。
static int SOUTHEAST
          将组件置于其显示区域的右下角。
static int SOUTHWEST
          将组件置于其显示区域的左下角。
static int VERTICAL
          在垂直方向而不是水平方向上调整组件大小。
 double weightx
          指定如何分布额外的水平空间。
 double weighty
          指定如何分布额外的垂直空间。
static int WEST
          将组件置于其显示区域的左部,并在垂直方向上居中。
 
构造方法摘要
GridBagConstraints()
          创建一个 GridBagConstraint 对象,将其所有字段都设置为默认值。
GridBagConstraints(int gridx, int gridy, int gridwidth, int gridheight, double weightx, double weighty, int anchor, int fill, Insets insets, int ipadx, int ipady)
          创建一个 GridBagConstraints 对象,将其所有字段都设置为传入参数。
 
方法摘要
 Object clone()
          创建此网格包约束(grid bag constraint)的副本。
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

RELATIVE

public static final int RELATIVE
指定此组件为其行或列( gridwidthgridheight)中的倒数第二个组件,或者让此组件紧跟在以前添加的组件( gridxgridy)之后。

另请参见:
gridwidth, gridheight, gridx, gridy, 常量字段值

REMAINDER

public static final int REMAINDER
指定此组件是其行或列中的最后一个组件。

另请参见:
常量字段值

NONE

public static final int NONE
不重新调整组件大小。

另请参见:
常量字段值

BOTH

public static final int BOTH
在水平方向和垂直方向上同时调整组件大小。

另请参见:
常量字段值

HORIZONTAL

public static final int HORIZONTAL
在水平方向而不是垂直方向上调整组件大小。

另请参见:
常量字段值

VERTICAL

public static final int VERTICAL
在垂直方向而不是水平方向上调整组件大小。

另请参见:
常量字段值

CENTER

public static final int CENTER
将组件置于其显示区域的中心。

另请参见:
常量字段值

NORTH

public static final int NORTH
将组件置于其显示区域的顶部,并在水平方向上居中。

另请参见:
常量字段值

NORTHEAST

public static final int NORTHEAST
将组件置于其显示区域的右上角。

另请参见:
常量字段值

EAST

public static final int EAST
将组件置于其显示区域的右部,并在垂直方向上居中。

另请参见:
常量字段值

SOUTHEAST

public static final int SOUTHEAST
将组件置于其显示区域的右下角。

另请参见:
常量字段值

SOUTH

public static final int SOUTH
将组件置于其显示区域的底部,并在水平方向上居中。

另请参见:
常量字段值

SOUTHWEST

public static final int SOUTHWEST
将组件置于其显示区域的左下角。

另请参见:
常量字段值

WEST

public static final int WEST
将组件置于其显示区域的左部,并在垂直方向上居中。

另请参见:
常量字段值

NORTHWEST

public static final int NORTHWEST
将组件置于其显示区域的左上角。

另请参见:
常量字段值

PAGE_START

public static final int PAGE_START
沿显示区域的边缘居中放置组件,该显示区域与当前 ComponentOrienation 的页面开始部分相关。等同于水平方向的 NORTH。

另请参见:
常量字段值

PAGE_END

public static final int PAGE_END
沿显示区域的边缘居中放置组件,该显示区域与当前 ComponentOrienation 的页面结束部分相关。等同于水平方向的 SOUTH。

另请参见:
常量字段值

LINE_START

public static final int LINE_START
沿显示区域的边缘居中放置组件,在该区域中,当前 ComponentOrienation 的文本行正常开始。等同于水平的、从左到右方向的 WEST,以及水平的、从右到左方向的 EAST。

另请参见:
常量字段值

LINE_END

public static final int LINE_END
沿显示区域的边缘居中放置组件,在该区域中,当前 ComponentOrienation 的文本行正常结束。等同于水平的、从左到右方向的 EAST,以及水平的、从右到左方向的 WEST。

另请参见:
常量字段值

FIRST_LINE_START

public static final int FIRST_LINE_START
将组件置于其显示区域的一角,这一角的位置是页面中最后一个文本行按照当前的 ComponentOrienation 在页面中的开始位置。等同于水平的、从左到右方向的 NORTHWEST,以及水平的、从右到左方向的 NORTHEAST。

另请参见:
常量字段值

FIRST_LINE_END

public static final int FIRST_LINE_END
将组件置于显示区域的一角,在该区域中,当前 ComponentOrienation 的页面的第一个文本行正常结束。等同于水平的、从左到右方向的 NORTHEAST,以及水平的、从右到左方向的 NORTHWEST。

另请参见:
常量字段值

LAST_LINE_START

public static final int LAST_LINE_START
将组件置于其显示区域的一角,这一角的位置是页面中最后一个文本行按照当前的 ComponentOrienation 在页面中的开始位置。等同于水平的、从左到右的 SOUTHWEST,以及水平的、从右到左方向的 SOUTHEAST。

另请参见:
常量字段值

LAST_LINE_END

public static final int LAST_LINE_END
将组件置于其显示区域的一角,这一角的位置是页面中最后一个文本行按照当前的 ComponentOrienation 在页面中的结束位置。等同于水平的、从左到右的 SOUTHEAST,以及水平的、从右到左方向的 SOUTHWEST。

另请参见:
常量字段值

BASELINE

public static final int BASELINE
anchor 字段的可能值。指定组件应该沿主要行的基线水平居中和垂直对齐。如果组件没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

BASELINE_LEADING

public static final int BASELINE_LEADING
anchor 字段的可能值。指定组件应沿开始边水平放置。对于从左到右方向的组件,开始边是左边。组件沿主要行的基线垂直对齐。如果组件没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

BASELINE_TRAILING

public static final int BASELINE_TRAILING
anchor 字段的可能值。指定组件应沿结尾边水平放置。对于从左到右方向的组件,结尾边是右边。组件沿主要行的基线垂直对齐。如果组件没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

ABOVE_BASELINE

public static final int ABOVE_BASELINE
anchor 字段的可能值。指定组件应该水平居中对齐。垂直放置组件,使它的底边接触到开始行的基线。如果开始行没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

ABOVE_BASELINE_LEADING

public static final int ABOVE_BASELINE_LEADING
anchor 字段的可能值。指定组件应沿开始边水平放置。对于从左到右方向的组件,开始边是左边。垂直放置组件,使它的底边接触到开始行的基线。如果开始行没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

ABOVE_BASELINE_TRAILING

public static final int ABOVE_BASELINE_TRAILING
anchor 字段的可能值。指定组件应沿结尾边水平放置。对于从左到右方向的组件,结尾边是右边。垂直放置组件,使它的底边接触到开始行的基线。如果开始行没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

BELOW_BASELINE

public static final int BELOW_BASELINE
anchor 字段的可能值。指定组件应该水平居中对齐。垂直放置组件,使它的底边接触到开始行的基线。如果开始行没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

BELOW_BASELINE_LEADING

public static final int BELOW_BASELINE_LEADING
anchor 字段的可能值。指定组件应沿开始边水平放置。对于从左到右方向的组件,开始边是左边。垂直放置组件,使它的底边接触到开始行的基线。如果开始行没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

BELOW_BASELINE_TRAILING

public static final int BELOW_BASELINE_TRAILING
anchor 字段的可能值。指定组件应沿结尾边水平放置。对于从左到右方向的组件,结尾边是右边。垂直放置组件,使它的底边接触到开始行的基线。如果开始行没有基线,那么它会垂直居中对齐。

从以下版本开始:
1.6
另请参见:
常量字段值

gridx

public int gridx
指定包含组件的显示区域开始边的单元格,其中行的第一个单元格为 gridx=0。组件显示区域的开始边指的是水平的、从左到右的容器的左边缘,以及水平的、从右到左的容器的右边缘。值 RELATIVE 指定将组件放置在添加此组件之前刚刚添加到容器中的组件的后面。

默认值为 RELATIVEgridx 应为非负值。

另请参见:
clone(), gridy, ComponentOrientation

gridy

public int gridy
指定位于组件显示区域的顶部的单元格,其中最上边的单元格为 gridy=0。值 RELATIVE 指定将组件放置在添加此组件之前刚刚添加到容器中的组件的下面。

默认值为 RELATIVEgridy 应为非负值。

另请参见:
clone(), gridx

gridwidth

public int gridwidth
指定组件显示区域的某一行中的单元格数。

使用 REMAINDER 指定组件的显示区域,该区域的范围是从 gridx 到该行的最后一个单元格。使用 RELATIVE 指定组件的显示区域,该区域的范围是从 gridx 到它所在行的倒数第二个单元格。

gridwidth 应为非负,默认值为 1。

另请参见:
clone(), gridheight

gridheight

public int gridheight
指定在组件显示区域的一列中的单元格数。

使用 REMAINDER 指定组件的显示区域,该区域的范围是从 gridy 到该列的最后一个单元格。使用 RELATIVE 指定组件的显示区域,该区域的范围是从 gridy 到它所在列的倒数第二个单元格。

gridheight 应为非负,默认值为 1。

另请参见:
clone(), gridwidth

weightx

public double weightx
指定如何分布额外的水平空间。

网格包布局管理器计算出列的权重将是列的所有组件中最大的 weightx。如果得到的布局在水平方向上比需要填充的区域小,那么系统会将额外的空间按照其权重比例分布到每一列。权重为零的列不会得到额外的空间。

如果所有的权重都为零,则所有的额外空间都将出现在单元格的网格之间和左右边缘之间。

此字段的默认值为 0weightx 应为非负值。

另请参见:
clone(), weighty

weighty

public double weighty
指定如何分布额外的垂直空间。

网格包布局管理器计算出行的权重将是行的所有组件中最大的 weighty。如果得到的布局在垂直方向上比需要填充的区域小,则系统会将额外的空间按照其权重比例分布到每一行。权重为零的行不会得到额外的空间。

如果所有的权重都为零,则所有的额外空间都将出现在单元格的网格之间和上下边缘之间。

此字段的默认值为 0weighty 应为非负值。

另请参见:
clone(), weightx

anchor

public int anchor
当组件小于其显示区域时使用此字段。它可以确定在显示区域中放置组件的位置。

可能的值有三种:相对于方向的值、相对于基线的值和绝对值。相对于方向的值是相对于容器的组件方向属性进行解释的,相对于基线值是相对于基线进行解释的,绝对值则不然。绝对值有:CENTERNORTHNORTHEASTEASTSOUTHEASTSOUTHSOUTHWESTWESTNORTHWEST。方向相对值有:PAGE_STARTPAGE_ENDLINE_STARTLINE_ENDFIRST_LINE_STARTFIRST_LINE_ENDLAST_LINE_STARTLAST_LINE_END。相对于基线的值有:BASELINEBASELINE_LEADINGBASELINE_TRAILINGABOVE_BASELINEABOVE_BASELINE_LEADINGABOVE_BASELINE_TRAILINGBELOW_BASELINEBELOW_BASELINE_LEADINGBELOW_BASELINE_TRAILING。默认值为 CENTER

另请参见:
clone(), ComponentOrientation

fill

public int fill
当组件的显示区域大于它所请求的显示区域的大小时使用此字段。它可以确定是否调整组件大小,以及在需要的时候如何进行调整。

以下值适用于 fill

默认值为 NONE

另请参见:
clone()

insets

public Insets insets
此字段指定组件的外部填充,即组件与其显示区域边缘之间间距的最小量。

默认值为 new Insets(0, 0, 0, 0)

另请参见:
clone()

ipadx

public int ipadx
此字段指定组件的内部填充,即给组件的最小宽度添加多大的空间。组件的宽度至少为其最小宽度加上 ipadx 像素。

默认值为 0

另请参见:
clone(), ipady

ipady

public int ipady
此字段指定内部填充,即给组件的最小高度添加多大的空间。组件的高度至少为其最小高度加上 ipady 像素。

默认值为 0。

另请参见:
clone(), ipadx
构造方法详细信息

GridBagConstraints

public GridBagConstraints()
创建一个 GridBagConstraint 对象,将其所有字段都设置为默认值。


GridBagConstraints

public GridBagConstraints(int gridx,
                          int gridy,
                          int gridwidth,
                          int gridheight,
                          double weightx,
                          double weighty,
                          int anchor,
                          int fill,
                          Insets insets,
                          int ipadx,
                          int ipady)
创建一个 GridBagConstraints 对象,将其所有字段都设置为传入参数。注:因为使用此构造方法会妨碍源代码的可读性,所以此构造方法仅供自动源代码生成工具使用。

参数:
gridx - 初始 gridx 值。
gridy - 初始 gridy 值。
gridwidth - 初始 gridwidth 值。
gridheight - 初始 gridheight 值。
weightx - 初始 weightx 值。
weighty - 初始 weighty 值。
anchor - 初始 anchor 值。
fill - 初始 fill 值。
insets - 初始 insets 值。
ipadx - 初始 ipadx 值。
ipady - 初始 ipady 值。
从以下版本开始:
1.2
另请参见:
gridx, gridy, gridwidth, gridheight, weightx, weighty, anchor, fill, insets, ipadx, ipady
方法详细信息

clone

public Object clone()
创建此网格包约束(grid bag constraint)的副本。

覆盖:
Object 中的 clone
返回:
此网格包约束的副本
另请参见:
Cloneable

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策