- java.lang.Object
-
- java.awt.GridBagConstraints
-
- 实现的所有接口
-
Serializable,Cloneable
public class GridBagConstraints extends Object implements Cloneable, Serializable
GridBagConstraints类指定使用GridBagLayout类布局的组件的约束。- 从以下版本开始:
- 1.0
- 另请参见:
-
GridBagLayout, Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 static intABOVE_BASELINEanchor字段的可能值。static intABOVE_BASELINE_LEADINGanchor字段的可能值。static intABOVE_BASELINE_TRAILINGanchor字段的可能值。intanchor当组件小于其显示区域时使用此字段。static intBASELINEanchor字段的可能值。static intBASELINE_LEADINGanchor字段的可能值。static intBASELINE_TRAILINGanchor字段的可能值。static intBELOW_BASELINEanchor字段的可能值。static intBELOW_BASELINE_LEADINGanchor字段的可能值。static intBELOW_BASELINE_TRAILINGanchor字段的可能值。static intBOTH水平和垂直调整组件大小。static intCENTER将组件放在其显示区域的中心。static intEAST将组件放在显示区域的右侧,垂直居中。intfill当组件的显示区域大于组件的请求大小时,将使用此字段。static intFIRST_LINE_END将组件放置在其显示区域的角落,页面上的第一行文本通常将结束当前的ComponentOrientation。static intFIRST_LINE_START将组件放置在其显示区域的角落,页面上的第一行文本通常会从当前的ComponentOrientation开始。intgridheight指定组件显示区域的列中的单元格数。intgridwidth指定组件显示区域的行中单元格数。intgridx指定包含组件显示区域前沿的单元格,其中一行中的第一个单元格具有gridx=0。intgridy指定组件显示区域顶部的单元格,其中最顶层的单元格为gridy=0。static intHORIZONTAL水平调整组件大小但不垂直调整大小。Insetsinsets此字段指定组件的外部填充,组件与其显示区域边缘之间的最小空间量。intipadx此字段指定组件的内部填充,添加到组件的最小宽度的空间。intipady此字段指定内部填充,即添加到组件最小高度的空间。static intLAST_LINE_END将组件放置在其显示区域的角落,页面上的最后一行文本通常将结束当前的ComponentOrientation。static intLAST_LINE_START将组件放在其显示区域的角落,页面上的最后一行文本通常会从当前的ComponentOrientation开始。static intLINE_END将组件沿其显示区域的边缘居中放置,其中文本行通常将针对当前的ComponentOrientation结束。static intLINE_START将组件沿其显示区域的边缘居中放置,通常为当前的ComponentOrientation开始文本行。static intNONE不要调整组件的大小。static intNORTH将组件放在其显示区域的顶部,水平居中。static intNORTHEAST将组件放在其显示区域的右上角。static intNORTHWEST将组件放在其显示区域的左上角。static intPAGE_END将组件沿其显示区域边缘居中放置,该区域与当前ComponentOrientation的页面末尾相关联。static intPAGE_START将组件沿其显示区域的边缘居中放置,该区域与当前ComponentOrientation的页面开头相关联。static intRELATIVE指定此组件是下一个到最后一个组件在其行或列(gridwidth,gridheight),或者该组分被旁边的以前添加的组件(放置gridx,gridy)。static intREMAINDER指定此组件是其列或行中的最后一个组件。static intSOUTH将组件放在其显示区域的底部,水平居中。static intSOUTHEAST将组件放在其显示区域的右下角。static intSOUTHWEST将组件放在其显示区域的左下角。static intVERTICAL垂直调整组件大小但不水平调整大小。doubleweightx指定如何分配额外的水平空间。doubleweighty指定如何分配额外的垂直空间。static intWEST将组件放在其显示区域的左侧,垂直居中。
-
构造方法摘要
构造方法 构造器 描述 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, 常数字段值
-
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的页面末尾相关联。 水平方向等于南方。- 另请参见:
- 常数字段值
-
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 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指定将组件紧跟在添加此组件之前添加到容器的组件之后。默认值为
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
-
-