- java.lang.Object
-
- java.awt.GridBagConstraints
-
- All Implemented Interfaces:
-
Serializable
,Cloneable
public class GridBagConstraints extends Object implements Cloneable, Serializable
GridBagConstraints
类为使用GridBagLayout
类布局的组件指定了约束。- 从以下版本开始:
- 1.0
- 另请参见:
-
GridBagLayout
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 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
将组件放在其显示区域的一角,其中页面上的第一行文本正常结束当前的ComponentOrientation
。static int
FIRST_LINE_START
将组件放置在其显示区域的一角,其中页面上的第一行文本通常将为当前的ComponentOrientation
开始。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
将组件放置在其显示区域的一角,其中页面上的最后一行文本将正常结束当前的ComponentOrientation
。static int
LAST_LINE_START
将组件放置在其显示区域的一角,其中页面上的最后一行文本通常将为当前的ComponentOrientation
启动。static int
LINE_END
将组件沿其显示区域的边缘放置,其中文本行将正常结束当前的ComponentOrientation
。static int
LINE_START
将组件沿其显示区域的边缘放置,其中文本行正常开始为当前的ComponentOrientation
。static int
NONE
不要调整组件的大小。static int
NORTH
将组件放置在其显示区域的顶部,水平居中。static int
NORTHEAST
将组件放在其显示区域的右上角。static int
NORTHWEST
将组件放在其显示区域的左上角。static int
PAGE_END
将组件沿着与当前ComponentOrientation
的页面末尾相关联的显示区域的边缘ComponentOrientation
。static int
PAGE_START
将组件沿着与当前ComponentOrientation
的页面开头相关联的显示区域的边缘ComponentOrientation
。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
将组件放置在其显示区域的左侧,垂直居中。
-
构造方法摘要
构造方法 Constructor 描述 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
对象,其所有字段都设置为传入参数。
-
-
-
字段详细信息
-
RELATIVE
public static final int RELATIVE
指定此组件是下一个到最后一个组件在其行或列(gridwidth
,gridheight
),或者该组分被旁边的以前添加的组件(放置gridx
,gridy
)。- 另请参见:
-
gridwidth
,gridheight
,gridx
,gridy
, Constant Field Values
-
REMAINDER
public static final int REMAINDER
指定此组件是其列或行中的最后一个组件。- 另请参见:
- Constant Field Values
-
NONE
public static final int NONE
不要调整组件的大小。- 另请参见:
- Constant Field Values
-
BOTH
public static final int BOTH
水平和垂直调整组件的大小。- 另请参见:
- Constant Field Values
-
HORIZONTAL
public static final int HORIZONTAL
调整组件水平但不垂直。- 另请参见:
- Constant Field Values
-
VERTICAL
public static final int VERTICAL
垂直调整组件大小但不水平调整。- 另请参见:
- Constant Field Values
-
CENTER
public static final int CENTER
将组件放在其显示区域的中央。- 另请参见:
- Constant Field Values
-
NORTH
public static final int NORTH
将组件放置在其显示区域的顶部,水平居中。- 另请参见:
- Constant Field Values
-
NORTHEAST
public static final int NORTHEAST
将组件放在其显示区域的右上角。- 另请参见:
- Constant Field Values
-
EAST
public static final int EAST
将组件放置在显示区域的右侧,垂直居中。- 另请参见:
- Constant Field Values
-
SOUTHEAST
public static final int SOUTHEAST
将组件放在其显示区域的右下角。- 另请参见:
- Constant Field Values
-
SOUTH
public static final int SOUTH
将组件放在其显示区域的底部,水平居中。- 另请参见:
- Constant Field Values
-
SOUTHWEST
public static final int SOUTHWEST
将组件放在其显示区域的左下角。- 另请参见:
- Constant Field Values
-
WEST
public static final int WEST
将组件放置在其显示区域的左侧,垂直居中。- 另请参见:
- Constant Field Values
-
NORTHWEST
public static final int NORTHWEST
将组件放在其显示区域的左上角。- 另请参见:
- Constant Field Values
-
PAGE_START
public static final int PAGE_START
将组件沿与其当前的页面开头相关联的显示区域的边缘居中放置当前的ComponentOrientation
。 等于NORTH用于水平方向。- 另请参见:
- Constant Field Values
-
PAGE_END
public static final int PAGE_END
将组件沿着与当前ComponentOrientation
的页面末尾相关联的显示区域的边缘ComponentOrientation
。 相当于SOUTH的水平方向。- 另请参见:
- Constant Field Values
-
LINE_START
public static final int LINE_START
将组件沿其显示区域的边缘放置,其中文本行正常开始为当前的ComponentOrientation
。 水平,从左到右的方向相当于WEST,水平,从右到左的方向为EAST。- 另请参见:
- Constant Field Values
-
LINE_END
public static final int LINE_END
将组件沿其显示区域的边缘放置,其中文本行将正常结束当前的ComponentOrientation
。 相对于横向,左至右方向的EAST,水平,从右到左的方向为WEST。- 另请参见:
- Constant Field Values
-
FIRST_LINE_START
public static final int FIRST_LINE_START
将组件放置在其显示区域的一角,其中页面上的第一行文本通常将为当前的ComponentOrientation
开始。 相对于NORTHWEST,水平,从左到右的方向和NORTHEAST的水平,从右到左的方向。- 另请参见:
- Constant Field Values
-
FIRST_LINE_END
public static final int FIRST_LINE_END
将组件放置在其显示区域的一角,其中页面上的第一行文本将正常结束当前的ComponentOrientation
。 相对于NORTHEAST为水平,从左到右的方向,NORTHWEST为水平,从右到左的方向。- 另请参见:
- Constant Field Values
-
LAST_LINE_START
public static final int LAST_LINE_START
将组件放置在其显示区域的一角,其中页面上的最后一行文本通常将为当前的ComponentOrientation
启动。 相对于SOUTHWEST的水平,从左到右的方向和SOUTHEAST的水平,从右到左的方向。- 另请参见:
- Constant Field Values
-
LAST_LINE_END
public static final int LAST_LINE_END
将组件放置在其显示区域的一角,其中页面上的最后一行文本将正常结束当前的ComponentOrientation
。 相当于SOUTHEAST的水平,从左到右的方向和SOUTHWEST的水平,从右到左的方向。- 另请参见:
- Constant Field Values
-
BASELINE
public static final int BASELINE
可能的值为anchor
字段。 指定组件应沿着主要行的基准水平居中并垂直对齐。 如果组件没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
BASELINE_LEADING
public static final int BASELINE_LEADING
可能的值为anchor
字段。 指定组件应沿着前沿水平放置。 对于具有从左到右方向的组件,前缘是左边缘。 垂直地,组件沿着主要行的基线对齐。 如果组件没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
BASELINE_TRAILING
public static final int BASELINE_TRAILING
可能的值为anchor
字段。 指定组件应沿着后沿水平放置。 对于具有从左到右方向的组件,后缘是右边缘。 垂直地,组件沿着主要行的基线对齐。 如果组件没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
ABOVE_BASELINE
public static final int ABOVE_BASELINE
可能的值为anchor
字段。 指定组件应该水平居中。 垂直地将组件定位成使其底部边缘接触起始行的基线。 如果起始行没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
ABOVE_BASELINE_LEADING
public static final int ABOVE_BASELINE_LEADING
可能值为anchor
字段。 指定组件应沿着前沿水平放置。 对于具有从左到右方向的组件,前缘是左边缘。 垂直地将组件定位成使其底部边缘接触起始行的基线。 如果起始行没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
ABOVE_BASELINE_TRAILING
public static final int ABOVE_BASELINE_TRAILING
可能的值为anchor
字段。 指定组件应沿着后沿水平放置。 对于具有从左到右方向的组件,后缘是右边缘。 垂直地将组件定位成使其底部边缘接触起始行的基线。 如果起始行没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
BELOW_BASELINE
public static final int BELOW_BASELINE
可能的值为anchor
字段。 指定组件应该水平居中。 垂直地将组件定位成使其顶部边缘接触起始行的基线。 如果起始行没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
BELOW_BASELINE_LEADING
public static final int BELOW_BASELINE_LEADING
可能的值为anchor
字段。 指定组件应沿着前沿水平放置。 对于具有从左到右方向的组件,前缘是左边缘。 垂直地将组件定位成使其顶部边缘接触起始行的基线。 如果起始行没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
BELOW_BASELINE_TRAILING
public static final int BELOW_BASELINE_TRAILING
可能的值为anchor
字段。 指定组件应沿着后沿水平放置。 对于具有从左到右方向的组件,后缘是右边缘。 垂直地将组件定位成使其顶部边缘接触起始行的基线。 如果起始行没有基线,它将垂直居中。- 从以下版本开始:
- 1.6
- 另请参见:
- Constant Field Values
-
gridx
public int gridx
指定包含组件显示区域的前沿的单元格,其中一行中的第一个单元格具有gridx=0
。 组件显示区域的前沿是其左边缘,用于水平的从左到右的容器,其右边缘用于水平的从右到左的容器。 值RELATIVE
指定组件在添加到该组件之前添加到容器中的组件之后立即放置。默认值为
RELATIVE
。gridx
应为非负值。- 另请参见:
-
clone()
,gridy
,ComponentOrientation
-
gridy
public int gridy
指定组件显示区域顶部的单元格,其中最上面的单元格具有gridy=0
。 值RELATIVE
指定组件被放置在添加到该组件之前添加到容器的组件的正下方。默认值为
RELATIVE
。gridy
应为非负值。
-
gridwidth
public int gridwidth
指定组件显示区域的一行中的单元格数。使用
REMAINDER
指定组件的显示区域将从gridx
到行中的最后一个单元格。 使用RELATIVE
指定组件的显示区域将从gridx
到其行中最后一个。gridwidth
应为非负数,默认值为1。- 另请参见:
-
clone()
,gridheight
-
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
。- 另请参见:
-
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
。
-
-
构造方法详细信息
-
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
- 初始网格值。 -
gridwidth
- 初始gridwidth
值。 -
gridheight
- 初始gridheight
值。 -
weightx
- 初始weightx
值。 -
weighty
- 初始重量值。 -
anchor
- 初始锚值。 -
fill
- 初始填充值。 -
insets
- 初始insets
。 -
ipadx
- 初始ipadx值。 -
ipady
- 初始ipady值。 - 从以下版本开始:
- 1.2
- 另请参见:
-
gridx
,gridy
,gridwidth
,gridheight
,weightx
,weighty
,anchor
,fill
,insets
,ipadx
,ipady
-
-