GridBagConstraints

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 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` 指定此组件为其行或列（`gridwidth`、`gridheight`）中的倒数第二个组件，或者让此组件紧跟在以前添加的组件（`gridx`、`gridy`）之后。
`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

指定此组件为其行或列（gridwidth、gridheight）中的倒数第二个组件，或者让此组件紧跟在以前添加的组件（gridx、gridy）之后。

另请参见：: 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

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

BELOW_BASELINE_TRAILING

public static final int BELOW_BASELINE_TRAILING

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

gridx

public int gridx

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

默认值为 RELATIVE。gridx 应为非负值。

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

gridy

public int gridy

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

默认值为 RELATIVE。gridy 应为非负值。

另请参见：: 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。如果得到的布局在水平方向上比需要填充的区域小，那么系统会将额外的空间按照其权重比例分布到每一列。权重为零的列不会得到额外的空间。

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

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

另请参见：: clone(), weighty

weighty

public double weighty

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

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

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

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

另请参见：: clone(), weightx

anchor

public int anchor

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

可能的值有三种：相对于方向的值、相对于基线的值和绝对值。相对于方向的值是相对于容器的组件方向属性进行解释的，相对于基线值是相对于基线进行解释的，绝对值则不然。绝对值有：CENTER、NORTH、NORTHEAST、EAST、SOUTHEAST、SOUTH、SOUTHWEST、WEST 和 NORTHWEST。方向相对值有：PAGE_START、PAGE_END、LINE_START、LINE_END、FIRST_LINE_START、FIRST_LINE_END、LAST_LINE_START 和 LAST_LINE_END。相对于基线的值有：BASELINE、BASELINE_LEADING、BASELINE_TRAILING、ABOVE_BASELINE、ABOVE_BASELINE_LEADING、ABOVE_BASELINE_TRAILING、BELOW_BASELINE、BELOW_BASELINE_LEADING 和 BELOW_BASELINE_TRAILING。默认值为 CENTER。

另请参见：: clone(), ComponentOrientation

fill

public int fill

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

以下值适用于 fill：

NONE：不调整组件大小。
HORIZONTAL：加宽组件，使它在水平方向上填满其显示区域，但是不改变高度。
VERTICAL：加高组件，使它在垂直方向上填满其显示区域，但是不改变宽度。
BOTH：使组件完全填满其显示区域。

默认值为 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

构造方法详细信息

public GridBagConstraints()

创建一个 GridBagConstraint 对象，将其所有字段都设置为默认值。