- 所有已实现的接口:
-
Serializable
,Cloneable
GridBagConstraints
类指定使用GridBagLayout
类布局的组件的约束条件。
- 自从:
- 1.0
- 参见:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
anchor
字段的可能值。static final int
anchor
字段的可能值。static final int
anchor
字段的可能值。int
当组件小于其显示区域时使用此字段。static final int
anchor
字段的可能值。static final int
anchor
字段的可能值。static final int
anchor
字段的可能值。static final int
anchor
字段的可能值。static final int
anchor
字段的可能值。static final int
anchor
字段的可能值。static final int
水平和垂直同时调整组件大小。static final int
将组件放置在其显示区域的中心。static final int
将组件放置在其显示区域的右侧,垂直居中。int
当组件的显示区域大于组件请求的大小时使用此字段。static final int
将组件放置在其显示区域的角落,其中页面上的第一行通常会结束,适用于当前的ComponentOrientation
。static final int
将组件放置在其显示区域的角落,其中页面上的第一行通常会开始,适用于当前的ComponentOrientation
。int
指定组件显示区域中一列的单元格数。int
指定组件显示区域中一行的单元格数。int
指定包含组件显示区域前沿的单元格,其中一行中的第一个单元格具有gridx=0
。int
指定位于组件显示区域顶部的单元格,其中最顶部的单元格具有gridy=0
。static final int
仅水平调整组件大小,不垂直调整。此字段指定组件的外部填充,即组件与其显示区域边缘之间的最小间距。int
此字段指定组件的内部填充,即要添加到组件最小宽度的空间量。int
此字段指定内部填充,即要添加到组件最小高度的空间量。static final int
将组件放置在其显示区域的角落,其中页面上的最后一行通常会结束,适用于当前的ComponentOrientation
。static final int
将组件放置在其显示区域的角落,其中页面上的最后一行通常会开始,适用于当前的ComponentOrientation
。static final int
将组件沿着与当前ComponentOrientation
的页面结束相关联的显示区域边缘居中。static final int
将组件沿着与当前ComponentOrientation
的页面开始相关联的显示区域边缘居中。static final int
不调整组件大小。static final int
将组件放置在其显示区域的顶部,水平居中。static final int
将组件放置在其显示区域的右上角。static final int
将组件放置在其显示区域的左上角。static final int
将组件沿着与当前ComponentOrientation
的页面结束相关联的显示区域边缘居中。static final int
将组件沿着与当前ComponentOrientation
的页面开始相关联的显示区域边缘居中。static final int
指定此组件是其列或行中倒数第二个组件(gridwidth
,gridheight
),或将此组件放置在先前添加的组件旁边(gridx
,gridy
)。static final int
指定此组件是其列或行中的最后一个组件。static final int
将组件放置在其显示区域的底部,水平居中。static final int
将组件放置在其显示区域的右下角。static final int
将组件放置在其显示区域的左下角。static final int
仅垂直调整组件大小,不水平调整。double
指定如何分配额外的水平空间。double
指定如何分配额外的垂直空间。static final int
将组件放置在其显示区域的左侧,垂直居中。 -
Constructor Summary
ConstructorDescription创建一个所有字段都设置为默认值的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
对象。 -
Method Summary
-
Field Details
-
RELATIVE
public static final int RELATIVE指定此组件是其列或行中倒数第二个组件(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将组件放置在其显示区域的边缘中心,与当前ComponentOrientation
的水平方向相等于NORTH。- 参见:
-
PAGE_END
public static final int PAGE_END将组件放置在与当前ComponentOrientation
页面末尾关联的显示区域边缘的中心位置。对于水平方向的布局,等同于SOUTH。- 参见:
-
LINE_START
public static final int LINE_START将组件放置在与当前ComponentOrientation
文本行通常开始的显示区域边缘的中心位置。对于水平方向,从左到右的布局等同于WEST,从右到左的布局等同于EAST。- 参见:
-
LINE_END
public static final int LINE_END将组件放置在与当前ComponentOrientation
文本行通常结束的显示区域边缘的中心位置。对于水平方向,从左到右的布局等同于EAST,从右到左的布局等同于WEST。- 参见:
-
FIRST_LINE_START
public static final int FIRST_LINE_START将组件放置在与当前ComponentOrientation
页面上第一行文本通常开始的显示区域角落。对于水平方向,从左到右的布局等同于NORTHWEST,从右到左的布局等同于NORTHEAST。- 参见:
-
FIRST_LINE_END
public static final int FIRST_LINE_END将组件放置在与当前ComponentOrientation
页面上第一行文本通常结束的显示区域角落。对于水平方向,从左到右的布局等同于NORTHEAST,从右到左的布局等同于NORTHWEST。- 参见:
-
LAST_LINE_START
public static final int LAST_LINE_START将组件放置在与当前ComponentOrientation
页面上最后一行文本通常开始的显示区域角落。对于水平方向,从左到右的布局等同于SOUTHWEST,从右到左的布局等同于SOUTHEAST。- 参见:
-
LAST_LINE_END
public static final int LAST_LINE_END将组件放置在与当前ComponentOrientation
页面上最后一行文本通常结束的显示区域角落。对于水平方向,从左到右的布局等同于SOUTHEAST,从右到左的布局等同于SOUTHWEST。- 参见:
-
BASELINE
public static final int BASELINEanchor
字段的可能值。指定组件应水平居中,并垂直对齐于当前行的基线。如果组件没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
BASELINE_LEADING
public static final int BASELINE_LEADINGanchor
字段的可能值。指定组件应沿着前沿放置。对于从左到右的布局,前沿是左边缘。垂直方向上,组件沿着当前行的基线对齐。如果组件没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
BASELINE_TRAILING
public static final int BASELINE_TRAILINGanchor
字段的可能值。指定组件应沿着后沿放置。对于从左到右的布局,后沿是右边缘。垂直方向上,组件沿着当前行的基线对齐。如果组件没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
ABOVE_BASELINE
public static final int ABOVE_BASELINEanchor
字段的可能值。指定组件应水平居中。垂直方向上,组件的位置使其底边与起始行的基线接触。如果起始行没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
ABOVE_BASELINE_LEADING
public static final int ABOVE_BASELINE_LEADINGanchor
字段的可能值。指定组件应沿着前沿放置。对于从左到右的布局,前沿是左边缘。垂直方向上,组件的位置使其底边与起始行的基线接触。如果起始行没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
ABOVE_BASELINE_TRAILING
public static final int ABOVE_BASELINE_TRAILINGanchor
字段的可能值。指定组件应沿着后沿放置。对于从左到右的布局,后沿是右边缘。垂直方向上,组件的位置使其底边与起始行的基线接触。如果起始行没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
BELOW_BASELINE
public static final int BELOW_BASELINEanchor
字段的可能值。指定组件应水平居中。垂直方向上,组件的位置使其顶边与起始行的基线接触。如果起始行没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
BELOW_BASELINE_LEADING
public static final int BELOW_BASELINE_LEADINGanchor
字段的可能值。指定组件应沿着前沿放置。对于从左到右的布局,前沿是左边缘。垂直方向上,组件的位置使其顶边与起始行的基线接触。如果起始行没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
BELOW_BASELINE_TRAILING
public static final int BELOW_BASELINE_TRAILINGanchor
字段的可能值。指定组件应沿着后沿放置。对于从左到右的布局,后沿是右边缘。垂直方向上,组件的位置使其顶边与起始行的基线接触。如果起始行没有基线,则会垂直居中。- 自:
- 1.6
- 参见:
-
gridx
public int gridx指定包含组件显示区域前沿的单元格,其中一行中的第一个单元格具有gridx=0
。组件显示区域的前沿是水平、从左到右容器的左边缘,从右到左容器的右边缘。值RELATIVE
指定组件应立即放置在刚刚添加到容器中的组件之后。默认值为
RELATIVE
。gridx
应为非负值。- 参见:
-
gridy
public int gridy指定组件显示区域顶部的单元格,其中最顶部的单元格具有gridy=0
。值RELATIVE
指定组件应放置在刚刚添加到容器中的组件的下方。默认值为
RELATIVE
。gridy
应为非负值。- 参见:
-
gridwidth
public int gridwidth指定组件显示区域中一行的单元格数。使用
REMAINDER
指定组件的显示区域从gridx
到该行的最后一个单元格。使用RELATIVE
指定组件的显示区域从gridx
到该行的倒数第二个单元格。gridwidth
应为非负值,默认值为1。- 参见:
-
gridheight
public int gridheight指定组件显示区域中一列中的单元格数。使用
REMAINDER
指定组件的显示区域将从gridy
到该列的最后一个单元格。使用RELATIVE
指定组件的显示区域将从gridy
到其列中的倒数第二个单元格。gridheight
应为非负值,默认值为1。- 参见:
-
weightx
public double weightx指定如何分配额外的水平空间。网格包布局管理器计算一列的权重为该列中所有组件的最大
weightx
。如果生成的布局在水平方向上比需要填充的区域小,则额外空间按比例分配给每一列的权重。权重为零的列不会接收额外空间。如果所有权重都为零,则所有额外空间将出现在单元格的网格之间以及左右边缘之间。
此字段的默认值为
0
。weightx
应为非负值。- 参见:
-
weighty
public double weighty指定如何分配额外的垂直空间。网格包布局管理器计算一行的权重为该行中所有组件的最大
weighty
。如果生成的布局在垂直方向上比需要填充的区域小,则额外空间按比例分配给每一行的权重。权重为零的行不会接收额外空间。如果所有权重都为零,则所有额外空间将出现在单元格的网格之间以及顶部和底部边缘之间。
此字段的默认值为
0
。weighty
应为非负值。- 参见:
-
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
。- 参见:
-
fill
public int fill当组件的显示区域大于组件请求的大小时使用此字段,它确定是否调整组件的大小,以及如何调整。fill
的有效值如下:NONE
:不调整组件的大小。HORIZONTAL
:使组件足够宽以水平填充其显示区域,但不更改其高度。VERTICAL
:使组件足够高以垂直填充其显示区域,但不更改其宽度。BOTH
:使组件完全填充其显示区域。
默认值为
NONE
。- 参见:
-
insets
此字段指定组件的外部填充,即组件与其显示区域边缘之间的最小间距。默认值为
new Insets(0, 0, 0, 0)
。- 参见:
-
ipadx
public int ipadx此字段指定组件的内部填充,即要添加到组件最小宽度的空间量。组件的宽度至少为其最小宽度加上ipadx
像素。默认值为
0
。- 参见:
-
ipady
public int ipady此字段指定内部填充,即要添加到组件最小高度的空间量。组件的高度至少为其最小高度加上ipady
像素。默认值为0。
- 参见:
-
-
Constructor Details
-
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
- 参见:
-
-
Method Details